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Overview 


About This Manual 


The DYNIX/ptx Reference Manual is for programmers working in the 
DYNIX/ptx operating system environment. This manual describes the 
programming features of the operating system and assumes that the 
audience is familiar with the operating system. It does not provide a general 
overview of the operating system or implementation details of the system. 


Organization 
The DYNIX/ptx Reference Manual is contained in five binders organized as 
follows: 
¢ Section1A-F Commands 
¢ Section1G-Z Commands 
¢ Section 2 System Calls 
Section 2SEQ Sequent System Calls 
Section 3 Subroutines 
Section 3C C Library Routines 
Section 3M Mathematical Library Routines 
Section 3N Networking Support Utilities 
Section 3PPS Sequent Parallel Programming Library 
Section 3S Standard I/O Library Routines 
Section 38SEQ Sequent I/O Library Routines 
Section 3X Special Routines 
¢ ~=©Section 4 File Formats 
Section 5 Miscellaneous Facilities 
¢ Section 7 Special Files 
Section 8 Stand-alone Utilities 
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Each binder also contains the following items: @ 


¢ Table of Contents that alphabetically lists the contents of the entire 
manual set 


¢ Permuted Index that lists each programming feature in the entire 
manual set 


The permuted index is a list of keywords, given alphabetically in the second 
of three columns, together with the context in which each keyword is found. 
The following shows four separate entries illustrating four ways that the cat 
command can be looked up in the permuted index. Note that you can find the 
cat command by looking up “cat,” “concatenate,” “files,” or “print.” 


cat: concatenate and print files........... cat (1) 

cat: concatenate and print files.......seeeeeee cat (1) 

concatenate and print fileS.... cere eee ewer reece eee tence nen ereee cat (1) 
concatenate and print filesS...---.eeeee cece cece eect ee eecee cat (1) 


Keywords are either topical keywords or the names of manual entries 

themselves. Entries are identified with their section numbers shown in 

parentheses. The numbers are important because there is duplication of 

names among the sections. The right column lists the name of the manual ‘ 
page on which each keyword may be found. The left column contains useful © 
information about the keyword. 


The following paragraphs briefly describe the other sections of the manual. 


Section 1: Commands describes operating system commands and 
commands that support C and other programming languages. 


Section 2: System Calls describes the access to the services provided by the 
operating system kernel, including the C language interface. 


Section 2SEQ: Sequent System Calls describes the access to the Sequent 
services provided by the operating system kernel, including the C language 
interface. 


Section 3: Subroutines describes the available subroutines. Their binary 
versions reside in various system libraries in the directories /lib and 
/usr/lib. The introduction to Section 3 describes these libraries and the files 


in which they are stored. © 
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Section 4: File Formats documents the structure of particular kinds of 
files; for example, the format of the output of the link editor is given in 
a.out(4). Excluded are files used by only one command (for example, the 
assembler’s intermediate files). In general, the C language structures 
corresponding to these formats can be found in the directories /usr/include 
and /usr/include/sys. 


Section 5: Miscellaneous Facilities contains a variety of descriptions 
including descriptions of character sets, macro packages, and so forth. 


Section 7: Special Files describes various special files that refer to specific 
hardware peripherals and operating system device drivers. 


Section 8: Stand-alone Utilities describes stand-alone procedures. 


References to manual pages with numbers other than those above mean that 
the utility is contained in the appropriate section of another manual. Each 
section consists of independent entries which are alphabetized, with the 
exception of the introductions that begin some sections. Section 3 is divided 
into subsections in alphabetical order by suffix. Some entries may describe 
several routines, commands, and so forth. In such cases, the entry appears 
only once, alphabetized under its primary name, the name that appears at 
the upper corners of each manual page. 


Each manual page can be viewed online with the man(1) command. For 
example, enter man shell to view the shell manual page. Enter man man 
for more information about the man command. 


Notational Conventions 


Manual pages are based on a common format. The main headings are 
described here—not all of them appear in all cases: 


¢ NAME gives the name(s) of the entry and briefly states its purpose. 
This entry is used to create the Permuted Index and the Table of 
Contents. 


© SYNOPSIS summarizes the usage of the program being described. 
Conventions vary in some sections but are generally as follows: 
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¢ Boldface strings are literals and are to be typed just as they © 
appear. 


¢ Italic strings usually represent substitutable argument prototypes 
and program names found elsewhere in the manual. 


¢ Square brackets [] around an argument prototype indicate that 
the argument is optional. When an argument prototype is given 
as name or file, it refers to a filename. , 


e Ellipses ... are used to show that the previous argument 
prototype may be repeated. 


e A final convention is used by the commands themselves. An 
argument beginning with a minus -, plus +, or equal sign = is often 
taken to be some sort of flag argument even if it appears in a 
position where a file name could appear. Therefore, it is unwise to 
have files whose names begin with -, +, or =. 


¢ CONFIGURATION ENTRY shows how a driver is called out in a system 
configuration file. 


¢ DESCRIPTION describes the entry, including its purpose and how it is 
used. 


e FIELDS describe system file or record entries. 
e EXAMPLES and BINARY CONFIGURATION give examples of usage. 


¢ FILES list files that are part of a program, created by a program, or 
related to a program. 


¢ SEE ALSO points to related information in other manual pages. 


© DIAGNOSTICS discuss the diagnostic (error) messages that may be 
produced. Messages that are self-explanatory are not listed. 


¢ WARNINGS contains warnings against improper user actions. 
¢ NOTES give hints about the use of the utility. 
© BUGS describe known bugs in the software. 
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1 Commands 


INtTO(1)  cerssssssseeees cdpbsausactassucosessaeeneceeaeneees introduction to maintenance commands and 

application programs 
300(1): 300, 300s ...... sein oachetenarcenstaa handle special functions of DASI 300 and 300s terminals 
4014(1) .. paginator for the Tektronix 4014 terminal 


. handle special functions of the DASI 450 terminal 
.. allow or prevent LP requests 


450(1) 
accept(1M): accept, reject ... 


acct(1M): acctdisk, acctdusg, accton, 


overview of accounting and miscellaneous 
accounting commands 
.. command summary from per-process accounting records 


acctcom(1) ....... aedadshactavecsenstees search and print process accounting files 
acctcon(1M): acctcon1, acctoon2 connect-time accounting 
acctmerg( 1M)  .sc.ssssssssssessesnees soon merge or add total accounting files 


acctpre(1M): acctprel, acctpre2 process accounting 
acctsh(1M): chargefee, ckpacct, 

dodisk, lastlogin, monacct, 

nulladm, pretmp, prdaily, prtacct, 

shutacct, startup, turnacct 


addcmdopt(1M) ... 


shell procedures for accounting 
add a command option to a menu 


addformopt(1M) add a form/SELECT window option to a menu 
addmenuopt(1M) . . add a menu option to a menu 
admin(1) ..... . create and administer SCCS files 


apropos(1) locate commands by keyword lookup 

ANCL) eessees sissh see C and Language Tools Binder 

as(1) see C and Language Tools Binder 

asa(1) .. interpret ASA carriage control characters 

assist(1) assistance using operating system commands 
astgen(1) . program for generating/modifying ASSIST menus or 


command forms 
. execute commands at a later time 
pattern scanning and processing language 
make posters 
deliver portions of pathnames 
arbitrary-precision arithmetic language 
.. system initialization procedures 


at(1): at, batch ... 
awk(1) .... 
banner{1) .. 
basename(1): basename, dirname 


bdflush(1M) .. update daemon 

bdiff(1) big diff 

bfs(1) ... .. big file scanner 

Domverify(1M) «sss .. perform an installation consistency check based on 
the BOM 

bootflags(1M) 

bp(1M) . 

cal(1) ... .. print calendar 
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.. Yeminder service 
convert a termcap description into a terminfo description 


calendar(1) 
captoinfo(1M) 


cat(1) wre concatenate and print files 

eb(1) .. see C and Language Tools Binder 

ec(1) . see C and Language Tools Binder 

ed(1) . change working directory 

cede(1) change the delta commentary of an SCCS delta 
cflow(1) ... .. see C and Language Tools Binder 

checkeq(1) .. check documents for correct eqn syntax. 
checkfsys(1M) check a filesystem 

chmod(1) ........ change mode 


chown(1): chown, chgrp 
chroot(1M) .. 


change owner or group 
change root directory for a command 


chrtbl(1M) generate character classification and conversion tables 
CCL) resseceevees check in RCS revisions 

ckbupscd(1M) check filesystem backup schedule 

clri(1M) clear inode 

emp(1) . compare two files 

co(1) . check out RCS revisions 

col(1) filter reverse line-feeds 


comb(1) ... combine SCCS deltas 

COMM) crsssssersesssseresssnesersesessersesterseseeseee select or reject lines common to two sorted files 
compress(1); compress, 
uncompress, zcat ... 
config(1M) 
coproc(1F): cocreate, cosend, 
cocheck, coreceive, codestroy . 
cp(1): cp, ln, mv 


... compress and expand data 
.. build system configuration files 


.. communicate to a process 
copy, link or move files 


cpp(1) ... see C and Language Tools Binder 

cpio(1) . copy file archives in and out 

cpra(1) .. see C and Language Tools Binder 

cpset(1) ... copy file and set mode, user, and group IDs 
crash(1M) examine system images 

cron(1M) . ... clock daemon 

crontab(1) .. user crontab file 

crypt(1) encode/decode 

esh(1) ... a shell (command interpreter) with C-like syntax 
cesplit(1) context split 

ct(1C) ... spawn getty to a remote terminal 

ctags(1) create a tags file 

ctrace(1) see C and Language Tools Binder 


cu(1C) ... call another UNIX system 

cut out selected fields of each line of a file 
see C and Language Tools Binder 

print and set the date 

see C and Language Tools Binder 

desk calculator 

filesystem directory consistency check 
convert and copy a file 

.. make a delta (change) to an SCCS file 
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sa 


GEYOUCL): ccsvesssscesssesseacavsececscssescesteswenssseseee remove nroff, tbl, and eqn constructs 
devbuild(1M): devbuild, 
devdestroy .. build and destroy virtual devices 


devnm(1M) : 


. device name 
d{{1M) ... . report number of free disk blocks and inodes 
diff) . . differential file comparison 
diff3(1) .. 3-way differential file comparison 
diremp(1) ... directory comparison 
dis(1) ...... . see C and Language Tools Binder 
diskusg(1M) . generate disk accounting data by user ID 
ditsectbl(1M) ... . refresh security table 
dmesg(1M) . collect system diagnostic messages to form error log 
du(1M) .... . Summarize disk usage 
dump(1) . . see C and Language Tools Binder 
dump{1M) . . incremental filesystem dump 
dumpconf(1M) . . dump kernel auto-configuration device table 
dumpfs(1M) . . dump filesystem information 
ec(1M) .... . forms compiler 
echo(1) ... . echo arguments 
echo(1F) . put string on virtual output 
ed(1): ed, re . text editor 
edc(1M) . Tun an externally described command 
edit(1) . text editor (variant of ex for casual users) 
edquota(1M) . edit user quotas 
efi(1) .. . Extended Fortran Language 
egrep(1) . . search a file for a pattern using full regular expressions 


. enable/disable LP printers 

. set environment for command execution 

. text editor 

. evaluate arguments as an expression 

. obtain the prime factors of a number 

. list filenames and statistics for a filesystem 

. search a file for a character string 

. determine file type 

. find files 

. format disks or perform other defect management 
functions 

filesystem consistency check and interactive repair 
. install random inode generation numbers 

feplit(1) ..... . split £77, ratfor, or efi files 


enable(1): enable, disable 


festat(1M) . . report filesystem status 
fstyp(1M) ... . determine filesystem identifier 
fuser(1M)  ......+ . identify processes using a file or file structure 


fwtmp(1M): fwtmp, wtmp . manipulate connect accounting records 
gdev(1G): hpd, erase, hardcopy, 

tekset, td .. . graphical device routines and filters 
. graphical editor 

. create a front-end to the cc command 
. get a version of an SCCS file 


. returns the current frame number 
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.. Teturns a list of the currently marked menu items © 


getitems(1F) ... 
parse command options 


getopt(1) .. 


getopts(1): getopts, getoptcvt parse command options 

getty(1M) ..... set terminal type, modes, speed, and line discipline 

glossary(1) .. .. definitions of common operating system terms and 
symbols 

graph(1G) .. draw a graph 

graphics(1G) access graphical and numerical commands 

greek(1) .. Select terminal filter 

grep(1) .. .. search a file for a pattern 

groups(1) show group memberships 

gutil(1G) graphical utilities 

help(1) ... operating system Help Facility 

helpadm(1M) change the Help Facility database 

hp(1) ..... handle special functions of Hewlett-Packard terminals 

hpio(1) Hewlett-Packard 2645A terminal tape file archiver 

icheck(1M) filesystem storage consistency check 

id(1M) ... print user and group IDs and names 

ident(1) . identify files 

indicator(1F) .. display application specific alarms and/or the 
working indicator 


... compare or print out terminfo descriptions 

process control initialization 

install commands . 
installs a boot program on a disk 

.. Temove a message queue, semaphore set, or shared 

memory ID 

.. Teport inter-process communication facilities status 

ISIS file manager, updates text files in ISIS file format 

relational database operator 

terminate a process 

kill all active processes 

.. the KornShell, a standard/restricted command and 


ksh(1): ksh, rksh 


programming language 

labelit(1M) provide labels for filesystems 
ld(1) .. see C and Language Tools Binder 
lex(1) generate programs for simple lexical tasks 
line(1) read one line 

i link and unlink files and directories 
lint(1) ... see C and Language Tools Binder 
list(1) ... see C and Language Tools Binder 
locate(1) use keywords to identify an operating system command 
login(1) sign on 
logname(1) get login name 
lorder(1) see C and Language Tools Binder 
1p(1): Ip, cancel . send/cancel requests to the LP print service 
Ipadmin(1M) .. configure the LP print service 
Ipfilter(1M) . administer filters used with the LP print service 
Ipforms(1M) ... .. administer forms used with the LP print service 
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Ipsched(1M): Ipsched, lpshut, 


Ipmove .... start/stop the LP print service and move requests 
Ipstat(1) .. print information about the status of the LP print service 
Ipusers(1M) . set printing queue priorities 

Js(1) .. list contents of directory 


m4(1) . macro processor 
machid(1): i386, ns32000, pdp11, 
USh), UBHZ, UBD, VAX  ssescvsssesseeesereeseereree get processor type truth value 


mail(1): mail, rmail . send mail to users or read mail 


mailbug(1) . submit a bug report or enhancement request 
mailx(1) ...... . interactive message processing system 

make(1) .scsssececsee maintain, update, and regenerate groups of programs 
makealiases(1M): makealiases, 

makewhatis .. generate man page databases 

makedev(1M) . make system special files 

makekey(1) generate encryption key 

man(1) .... . display on-line man pages 

mes(1) .. . manipulate the object file comment section 
menu(1M) . . menu processor 


menumsg(1M) . Toute user message to menu message queue 
. three-way file merge 

. permit or deny messages 

. puts its arguments on message line 

. make directories 

. construct a filesystem 


build special file 


mkpwdbm(1M) . make a database for fast password lookup 
mkvtoc(1M) ... populate VTOC on disks 

monitor{1M) ..... monitor system activity 

MHOTO(L)) scsscsssssssascsssasicsssseasincsersnes . View a file one full screen at a time 


mount(1M): mount, umount .. . mount and unmount filesystems 
mountall(1M): mountall, 


umountall . 


. mount, unmount multiple filesystems 


mt(1) 0 . magnetic tape manipulating program 
mvdir(1M) . move a directory 

nawk(1) .. . pattern scanning and processing language 
ncheck(1M) . generate pathnames from i-numbers 
newform(1) change the format of a text file 

newfa(1M) . . construct a new file system 

newgrp(1M) log in to a new group 

news(1) . print news items 

nice(1) .. . Tun a command at low priority 


ni(1) . line numbering filter 
nm(1) .. . see C and Language Tools Binder 
noage(1M): noage, nopff, noswap, 


OMPKOG: .ctssssiseasbtaseceteamsscsenancesseatecsertesecces run a command with priority aging, PFF, swapping, 
or processor migration disabled 

. run a command immune to hangups and quits 

. octal dump 

. bring processors online and offline 


online(1M): online, offline 
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pack(1): pack, peat, unpack .. compress and expand files 


passmgmt(1M) .... .. password files management 

passwd(1) . .. change login password and password attributes 

paste(1) .... .. merge same lines of several files or subsequent lines 
of one file 

PAthConV( LF) ...ecesssssscesnreseseenssnssnsereneenes search Interpreter criteria for filename 


.. see C and Language Tools Binder 

file perusal filter for CRTs 

.. display or alter parameters of virtual-to-physical 
mapping devices 

.. print files 

display profile data 

.. prompt program 

ey: .. print an SCCS file 

print the VTOC of a block device 

report process status 

password/group file checkers 


pwek(1M): pwek, grpck 


PWCONV(1M)  sesssessesseseeneen .. installs and updates /etc/shadow with information 
from /etc/passwd 

.. working directory name 

.. daemon to oversee password database creation 
pwfix(1M) ..... .. remove incorrectly formatted password entries 
pwunconv(1M) converts from a two to a one password file scheme 
quota(1) . display disk usage and limits 
quotacheck(1M) .. filesystem quota consistency checker 
quotaon(1M): quotaon, quotaoff turn filesystem quotas on and off 
ratfor(1) .... rational Fortran dialect 
rc0(1M) .. run commands performed to stop the operating system 
re2(1M) run commands performed for multi-user environment 


change RCS file attributes 
.. compare RCS revisions 
.. introduction to RCS commands 


res(1) .. 
resdiff(1) 
rcsintro(1) 


resmerge(1) merge RCS revisions 

readfile(1F): readfile, longline reads file and gets longest line 

regemp(1) . regular expression compile 

regex(1F) .. match patterns against a string 

reinit(1F) run an initialization file 

repquota(1M) summarize quotas for a filesystem 

reset(1F) ....... reset the current form field to its default values 
restore(1M) incremental filesystem restore 


Tlog(1) «ss... print log messages and other information about RCS files 
rm(1): rm, rmdir remove files or directories 
rmdel(1) ... remove a delta from an SCCS file 


rmvopt(1M) .. remove a menu option 

run(1F) ..... ww. Tun an executable 

runacct(1M) . .. Tun daily accounting 

sact(1) print current SCCS file editing activity 
sag(1G) system activity graph 

sar(1) . system activity reporter 


.. system activity report package 
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savecore(1M) .. Bave a core dump of the operating system 


scesdiff(1) ... compare two versions of an SCCS file 

scestorces(1) .. .- build RCS file from SCCS file 

sdiff(1) side-by-side difference program 

sed(1) .. .. stream editor 

set(1F): set, unset . set and unset environment variables in core or in files 

setcolor(1F) ... redefine or create a color 

setmnt(1M) establish mount table 

setpgrp(1) run command in its own process group 

setup(1) ... . initialize system for first user 

sh(1): sh, rsh. . shell, the standard/restricted command 
programming language 

BHOMIGLE): sessscsctcvcsccsnsssesescesevapsossavscsnseoescecs run a command using shell 

showcfg(1M) . show the configuration of the machine 


shutdown(1M) . shut down system, change system state 
. see C and Language Tools Binder 
. suspend execution for an interval 


. sort and/or merge files 


spell(1): spell, hashmake, spellin, 


Thashche ck. ....sscssessssssscerseseneres ssastessshaster: find spelling errors 

spline(1G) . interpolate smooth curve 

split(1) .... split a file into pieces 

starter(1) . information about the operating system for 
beginning users 

stat(1G) ..... statistical network useful with graphical commands 

strace(1M) .. print STREAMS trace messages 

strclean(1M) see STREAMS error logger cleanup program 

strerr(1M) STREAMS error logger daemon 

strip(1) . see C and Language Tools Binder 

stty(1) .. . set the options for a terminal 

su(1M) . . become superuser or another user 

sum(1) .... . print checksum and block count of a file 

swap(1M) . swap administrative interface 

sweepon(1M): sweepon, sweepoff . enable/disable patrol seeks on DCC disks 

sync(1M) . . update the superblock 

sysadm(1) . menu interface to do system administration 

tabs(1) . . set tabs on a terminal 

tail(1) deliver the last part of a file 

tar(1) ... .. tape file archiver 

tasktbl(1M) . create security table in shared memory 

tee(1) . pipe fitting 

test(1) . condition evaluation command 

tfipe(1M) ... interprocess communication reporter 

tfmenush(1M) . assign menu system as user login shell 

tfnotify(1M) ... send completion message 

tic(1M) .. . terminfo compiler 


. time a command 

. time a command; report process data and system activity 
. graphical table of contents routines 

.. update access and modification times of a file 


time(1): time, ptime 
timex(1) .....ssessssessereees 
toc(1G): dtoc, ttoc, vtoc 
touch(1) wes sanevesdenses 
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.. graphics filters 
initialize a terminal or query terminfo database 


tplot(1G) ... 
tput(1) 


tr(1) ... translate characters 
true(1): true, false . provide truth values 
ESOTH( 1) rressscsessonenen a topological sort 


tty( 1) vrecveesererceen: get the name of the terminal 

ttydevname(1) .. get the device associated with a terminal or the 
terminal associated with a device 

tumefe( 1M)  ecscscssscssscsseeresssssecnensserersenenees tune up an existing filesystem 

uadmin(1M) . .. administrative control 

umask(1) .. set file-creation mode mask 

uname(1) print name of current system 

unget(1) . undo a previous get of an SCCS file 

uniq(1) report repeated lines in a file 

units(1) .. conversion program 

uptime(1) show how long system has been up 

usage(1) .....0 retrieve a command description and usage examples 

uucheck(1M) check the uucp directories and permissions file 

uucico(1M) ... file transport program for the uucp system 

uucleanup(1M) ... .. uucp spool directory clean-up 

uucp(1C): uucp, uulog, uuname .. UNIX-to-UNIX system copy 

uugetty(1M) ..... set terminal type, modes, speed, and line discipline 

uusched(1M) the scheduler for the uucp file transport program 

uustat(1C) .... uucp status inquiry and job control 

uuto(1C): uuto, uupick public UNIX-to-UNIX system file copy 

uutry(1M) . .. try to contact remote system with debugging on 

uux(1C) . . UNIX-to-UNIX system command execution 

uuxqt(1M) .. execute remote command requests 

val(1) . validate SCCS file 

ve(1) ... version control 

vi(1) ... screen-oriented (visual) display editor based on ex 

vmtune(1M) . tune system-wide virtual-memory parameters 

volcopy(1M) . make literal copy of filesystem 

vaig(1F) . .. synchronize a co-process with the controlling FMLI object 

wait(1) .. await completion of process 

wall(1) write to all users 

we(1) .. word count 

what(1) . identify SCCS files 

whatis(1) describe what a command is 

who(1) ..... who is on the system 

whodo(1M) who is doing what 

write(1) . write to another user 

xarge(1) . construct argument list(s) and execute command 

yace(1) ... .. yet another compiler-compiler 
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2 System Calls 


intro(2) .... introduction to system calls and error numbers 
access(2) determine accessibility of a file 

acct(2) ... enable or disable process accounting 
alarm(2) ... set a process alarm clock 

brk(2): brk, sbrk .. change data segment space allocation 
chdir(2) ..... change working directory 

chmod(2) .. change mode of file 

chown(2) .. change owner and group of a file 

chroot(2) .. change root directory 

close(2) . close a file descriptor 

creat(2) . create a new file or rewrite an existing one 
dup(2) .. duplicate an open file descriptor 

dup2(2) . duplicate an open file descriptor 


exec(2): execl, execv, execle, 
execve, execlp, execvp . 
exit(2): exit, exit ..... 
fentl(2) .. 


execute a file 
terminate process 
file control 


fork(2) ... , create a new process 

getdents(2) .. read directory entries and put ina file system 
independent format 

getgroups(2) .. get supplementary group IDs 

getmsg(2) .... get next message off a stream 


getpid(2): getpid, getpgrp, getppid .... get process, process group, and parent process IDs 
getuid(2): getuid, geteuid, getgid, 


IDOLE GT, sssscstcscsasecsvesecsssssvsisaescssnseivesseenaen get real user, effective user, real group, and effective 
group IDs 

FOCEI(2)  sessssceesssecasesennaseee saaniussesaeses ssseeeee Control device 

kill(2) ... ... Send a signal to a process or a group of processes 

link(2) link to a file 


Iseek(2) move read/write file pointer 

mkdir(2) make a directory 

mknod(2): make a directory, or a special or ordinary file 
mount(2) . mount a filesystem 

msgetl(2) .. message control operations 


msgget(2) get message queue 

msgop(2) message operations 

nice(2) ... change priority of a process 

open(2) . open for reading or writing 
pathconf{2): pathconf, fpathconf . get configurable pathname variables 
pause(2) ... suspend process until signal 

pipe(2) .. create an interprocess channel 
plock(2) lock process, text, or data in memory 
poll(2) ... STREAMS input/output multiplexing 
profil(2) execution time profile 

ptrace(2): ptrace, mptrace process trace facility 

putmsg(2) send a message on a stream 

read(2) ..... read from file 

rename(2) change the name of a file 

rmdir{2) .... remove a directory 
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semct](2) semaphore control operations 
semget(2) . get set of semaphores 

semop(2) .... semaphore operations 

setpgid(2) . manipulate signal sets 

setpgrp(2) .. set process group ID 

setsid(2) .... create session and set process group ID 
setuid(2): setuid, setgid set user and group IDs 

BHMCH](Z)  ..esrersesneneee shared memory contro] operations 
Shmget(2) ssssscveee get shared memory segment identifier 


shmop(2): shmop, shmat, shmdt shared memory operations 


BIQACtION(2Z) .....sesecveeeves seavesenescseses assess EXAMine and change signal actions 
sigemptyset(2): sigemptyset, 

sigfillset, sigaddset, sigdelset, 

sigismember seas .. Manipulate signal sets 

signal(2) ..... 5 specify what to do upon receipt of a signal 
sigpending(2) .. examine pending signals 

sigprocmask(2) .. examine and change blocked signals 


sigset(2): sigset, sighold, sigrelse, 
sigignore, sigpause 
sigsuspend(2) .. 
stat(2): stat, Istat, fetat .. 
statfa(2): statfs, fstatfa 
stime(2) .... 


.. Signal management 

wait for a signal 

get file status 

get filesystem information 
set time 


stty(2): stty, gtty ... set and get terminal state (defunct) 
BYDC(Z) oeveee ... update superblock 

syscall(2) ... indirect system call 

BYBCOMM(Z) sreseaes get configurable system variables 
sysi86(2) ... machine specific functions 
tegetattr(2): tcgetattr, tesetattr get/set terminal state 

tegetpgrp(2) . get foreground process group ID 
tesetpgrp(2) . set foreground process group ID 
time(2) ...... get time 


get process and child process times 
.. administrative contro] 
.. get and set user limits 


ulimit(2) ... 

umask(2) .. set and get file creation mask 
umount(2) unmount a filesystem 

uname(2) .. get name of current operating system 
unlink(2) remove directory entry 

ustat(2) .. get filesystem statistics 

utime(2) ... set file access and modification times: 


spawn new process in a virtual memory efficient way 
wait for a child process to stop or terminate 
.. Write on a file 


vfork(2) ..... 
wait(2): wait, waitpid . 
WYItE(Z)  ssoccesnossren — 
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2SEQ Sequent System Calls 


intro(2SEQ) ... introduction to Sequent system calls 
bdflush(2SEQ) . . update daemon 

fvhangup(2SEQ) . . virtually hangup the specified controlling terminal 
get_process_stats(2SEQ) . get resource utilization information 
getdtablemax(2SEQ) .. . get maximum in-use descriptor table index 
getdtablesize(2SEQ) . get descriptor table size 

getpagesize(2SEQ) . . get system page size 

mmap(2SEQ) ...... . map an open file into the processs address space 
munmap(2SEQ) . . unmap part of the processs address space 
proc_ctl(2SEQ) ... . control over various process attributes 
quotactl(2SEQ) .... . manipulate disk quotas 

readlink(2SEQ) . read value of a symbolic link 

readv(2SEQ) ... . read vector from file 

setdtablesize(2SEQ) . set descriptor table size 

setgroups(2SEQ) ..... . set group access list 

sigcontext(2SEQ) « get signal context 

sigstack(2SEQ) ... . set anW/or get signal stack context 
symlink(2SEQ) ... . make symbolic link to a file 

tmp_affinity(2SEQ) . bind a process to a processor 

tmp_ctl(2SEQ) multi-processor control 


truncate(2SEQ): truncate, 


ftruncate ... . truncate a file to a specified length 
vm_ctl(2SEQ) . . examine and change virtual memory tuning parameters 
writev(2SEQ) write vector on a file 


3 Subroutines 
PREETI) ssc scnccesesataassiintioeavtcanaieoneieinee introduction to functions and libraries 


3C C Library Routines 


A641(8C): 064], 1648 wceesccsecsseessseee convert between long integer and base-64 ASCII string 
abort(3C) . generate an IOT fault 

abs(3C) ..... . return integer absolute value 

bsearch(3C) . . binary search a sorted table 

clock(3C) ..... . report CPU time used 

conv(3C): toupper, tolower, 

_toupper, _tolower, toascii .......sssessee translate characters 

crypt(3C): crypt, setkey, encrypt ........ generate hashing encryption 


ctime(3C): ctime, localtime, 
gmtime, asctime, cftime, ascftime, 
mktime, tzset .. 
ctype(3C): isdigit, isxdigit, 
islower, isupper, isalpha, isalnum, 

isspace, iscntrl, ispunct, isprint, 

isgraph, isascii, tolower, toupper, 

toascci, _tolower, _toupper, 

BECCHY CASS ...scscsssssssssssssssescceseecacsnssnsoncans character handling 


convert date and time to string 
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dev_to_ttyname(3C): sedi 
ttyname_to_dev . 
dial(3C) 
drand48(3C): drand48, erand48, 

Jrand48, nrand48, mrand48, 

jrand48, srand48, seed48, lcong48 ...... generate uniformly distributed pseudorandom numbers 
ecvt(3C): ecvt, fevt, gcvt .... convert floating-point number to string 

end(3C): end, etext, edata . .. last locations in program 

fpgetround(3C): fpgetround, 

fpsetround, fpgetmask, fpsetmask, 

f{pgetsticky, fpsetsticky .. IEEE floating-point environment control 

frexp(3C): frexp, ldexp, modf ... manipulate parts of floating-point numbers 

FEW(BC)  .esveee .. walk a file tree 

getewd(3C) get pathname of current working directory 

getenv(3C) .. .. return value for environment name 

getgrent(3C): getgrent, getgrgid, 

getgrnam, setgrent, endgrent, 


. convert between major/minor numbers and tty names 
.. establish an out-going terminal line connection 


fgetgrent .. get group file entry 

getlogin(3C) get login name 

getopt(3C) . get option letter from argument vector 
getpass(3C) .. read a password 

getpw(3C) .... .. get name from UID 


getpwent(3C): getpwent, 
getpwuid, getpwnam, setpwent, 

endpwent, fgetpwent ...sessnnereeee Bet password file entry 
getut(3C): getutent, getutid, 

getutline, pututline, setutent, 

endutent, utmpname, getutpid ........++ access utmp file entry 
hsearch(3C): hsearch, hcreate, 

hdestroy .. 
isnan(3C): isnand, isn: 
18tol(3C): 13tol, ltol3 
Tock f(3C) ..essssersessenees 
lsearch(3C): lsearch, lfind . 
malloc(3C): malloc, free, realloc, 

CALIO® srecccsrcssessorsssncesnensscencacensnsessecsensnenese main memory allocator 
memory(3C): memcecpy, memebr, 

memcmp, memcpy, memset 


manage hash search tables 

.. test for floating-point NaN (Not-A-Number) 
convert between 3-byte integers and long integers 
record locking on files 

linear search and update 


memory operations 


mkfifo(3C) ... make a FIFO special file 
mktemp(3C) make a unique filename 
monitor(3C) . prepare execution profile 
nlist(3C) ese .. get entries from name list 


perror(3C): perror, errno, 


sys_errlist, sys_nerr system error messages 


putenv(3C) .. change or add value to environment 
putpwent(3C) . write password file entry 
qsort(3C) ........ quicker sort 


rand(3C): rand, srand 
setjmp(3C): setjmp, longjmp 
setlocale(3C) 


.. simple random-number generator 
non-local goto 
set programs location 
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sigsetjmp(3C): sigsetjmp, 
siglongjmp 
sleep(3C) . 
ssignal(3C): ssignal, gsignal 


Contents 


.. non-local jumps 
.. suspend execution for interval 
.. software signals 


.. standard interprocess communication package 
.. format time information 


string(3C): treat, strdup, strncat, 
stremp, strncmp, strepy, strncpy, 
strlen, strchr, strrchr, strpbrk, 
strspn, strespn, strtok 
strstr(3C) 
strtod(3C): strtod, atof . 
strtol(3C): strtol, atol, atoi . 
swab(3C) 
tsearch(3C): tsearch, tfind, 
tdelete, twalk 
ttyname(3C): ityaaine, ieatty . 
ttyslot(3C) .....ccsreesssesees seectassoss 


.. string operations 


find first occurrence of character 
convert string to double-precision number 


.. Manage binary search trees 


find name of a terminal 


.. find the slot in the utmp file of the current user 


3M Mathematical Library Routines 


bessel(3M): jO, jl, jn, yO, yl, yn . 
erf(3M): erf, eric. cesses 
exp(3M): exp, log, log10, pow, sqrt 
floor(3M): floor, ceil, fmod, fabs . 
gamma(3M) . 
hypot(3M) . 
matherr(3M) . 
sinh(3M): sinh, cosh, tanh .....ssssssssssee 
trig(3M): sin, cos, tan, asin, acos, 

atan, atan2 ......... stdenasusisaaeedsagcasaasasensssess 


3N Networking Support Utilities 


t_accept(3N) . 
t_alloc(3N) 
t_bind(3N) . 
t_close(3N) .... 
t_connect(3N) 
t_error(3N) 
t_free(3N) ... 
t_getinfo(3N) .... 
t_getstate(3N) 
t_listen(3N) 
t_look(3N) .. 
t_open(3N) . 
t_optmgmt(3N) .. 
t_rev(3N) 


t_revrel(3N) .. 
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. error function and complementary error function 


exponential, logarithm, power, square root functions 


. floor, ceiling, remainder, absolute value functions 


log gamma function 


. Euclidean distance function 


error-handling function 


. hyperbolic functions 


trigonometric functions 


. accept a connect request 


allocate a library structure 

bind an address to a transport endpoint 

close a transport endpoint 

establish a connection with another transport user 
produce error message 

free a library structure 


. get protocol-specific service information 

. get the current state 

. listen for a connect request 

. look at the current event on a transport endpoint 

. establish a transport endpoint 

. manage options for a transport endpoint 

. receive data or expedited data sent over a connection 
. Teceive the confirmation from a connect request 


retrieve information from disconnect 
acknowledge receipt of an orderly release indication 
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.. Teceive a data unit 
... receive a unit data error indication 
.. send data or expedited data over a connection 


t_revudata(3N) 
t_revuderr(3N) 


t_snd(3N) .... 

t_snddia(3N) send user-initiated disconnect request 
t_sndrel(3N) .. initiate an orderly release 
t_sndudata(3N) .. send a data unit 

t_sync(3N) ...... synchronize transport library 
t_unbind(3N) .... disable a transport endpoint 


3PPS Sequent Parallel Programming Library 


intro(3PPS) 
brk(3PPS): brk, sbrk 
cpus_online(3PPS) 
m_fork(3PPS) .... 


... introduction to Parallel Programming Library 
.. change private data segment size 

... returns the number of CPUs on-line 

.. execute a subprogram in parallel 
m_get_myid(3PPS) .. ... return process identification 
m_get_numproca(3PPS) ... return number of child processes 
m_kill_proca(3PPS) ........ ». kill child processes 


m_lock(3PPS): m_lock, m_unlock ...... lock, unlock locks 

M_NEXt(BPPS) -srssssseserveeeseeee ... increment global counter 
m_park_procs(3PPS): gui 

m_rele_procs .. suspend and resume child process execution 
m_set_procs(3PPS) . .. set number of child processes 
m_single(3PPS): m single, 

m_multi .. mark single-process code section 


m_sync(3PPS) .. check in at barrier 
s_lock(3PPS): s_init_lock, s_lock, 

s_clock, s_unlock ... 
s_wait_barrier(3PPS): 
s_wait_barrier 
shbrk(3PPS): shbrk, shsbrk ... 
shmalloc(3PPS): shmalloc, 
shrealloc, shfree 


.. initialize, lock, unlock locks 


.. initialize barrier, wait at barrier 
.. change shared data segment size 


.. shared memory allocator 


3S Standard I/O Library Routines 


ctermid(3S) ... 
cuserid(3S) ..... 
felose(3S): fclose, flush 
ferror(3S): ferror, feof, clearerr, 

FOMO cccccssrcscessccesecerserscscscsersersssecesosonseseee stream status inquiries 

fopen(3S): fopen, freopen, fdopen open a stream 

fread(3S): fread, fwrite 00 binary input/output 

feeek(3S): fseek, rewind, ftell reposition a file pointer in a stream 
getc(3S): gete, getchar, fgetc, getw .... get character or word from a stream 
geta(3S): gets, fgets get a string from a stream 
popen(3S): popen, pclose initiate pipe to/from a process 
printf(3S): printf, fprintf, sprintf .. print formatted output 


.. generate filename for terminal 
.. get character login name of the user 
.. close or flush a stream 
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putc(3S): putc, putchar, fpute, 


putw put character or word on a stream 


puts(3S): puts, fputs . . put a string on a stream 
scanf(3S): scanf, fecanf, sscanf convert formatted input 
setbuf(3S): setbuf, setvbuf .. . assign buffering to a stream 


stdio(3S) ....... 
system(3S) 
tmpfile(3S) ... 


. standard buffered input/output package 
. issue a shell command 
. create a temporary file 


tmpnam(3S): tmpnam, tempnanm ...... create a name for a temporary file 

UNgetC(BS) csscsscssessssessvsssssssvssensnesseneseene push character back into input stream 
vprint{(3S): vprintf, vfprintf, 

WADDTEMED scscissssasseissiaseessctatcastenenscevcctessesossas print formatted output of a varargs argument list 


8SEQ Sequent I/O Library Routines 


dis386(3SEQ) .. 
getgeombyname(3SEQ) 
getmntent(3SEQ): addmntent, 
endmntent, getmntent, 

hasmntopt, setmntent .. 


. disassemble Series 386 instructions 
get disk geometry by name 


.. get file system descriptor file entry 


getpseudotty(3SEQ) ... get pseudo terminals 
getscsiinfo(3SEQ): getscsiinfo, 

 BetSCSIMALCH ersssssssssssssscersnecesssnsecenseeeeee get scsiinfo structure 
getusclk(3SEQ): getusclk, 
USCIK_imit .essecerssssssnsvsesssnserssssssensscsssees get/init microsecond clock 
getzdinfo(3SEQ): getzdinfo, 
getzdinfobyname .... . get zdinfo structure 
initgroups(3SEQ) . initialize group access list 


nblocks(3SEQ) .. calculate number of blocks and indirect blocks 
offline_all(3SEQ) .. take all but one active processor off line 
read_constab(3SEQ) .. read constab entries into a structure 
valloc(3SEQ) .. aligned memory allocator 


3X Special Routines 


assert(3X) . .. verify program assertion 
crypt(3X) .. .. password and file encryption functions 
curses(3X) .. terminal screen handling and optimization package 


directory(3X): opendir, readdir, 

telldir, seekdir, rewinddir, closedir .... directory operations 
getspent(3X): getspent, getspnam, 

setspent, endspent, fgetspent, 


Ickpwdf, ulckpwdf .. .. get shadow password file entry 


Idahread(3X) ... .. Tread the archive header of a member of an archive file 
Idclose(3X): Idclose, .. close a common object file 

Idfhread(3X) ... .. read the file header of a common object file 
Idgetname(3X) .. retrieve symbol name for common object file symbol 


table entry 
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ldlread(3X): Idlread, ldlinit, ldlitem .. manipulate line number entries of a common object 


file function 

Idlseek(3X): Idlseek, Idnlseek...........0-+ seek to line number entries of a section of a common 
object file 

Idohseek(3X) ......sssssescscsessserers ane .. seek to the optional file header of a common object file 


ldopen(3X): ldopen, Idaopen 


2 .. open a common object file for reading 
ldrseek(3X): ldrseek, ldnrseek 


.. seek to relocation entries of a section of acommon 
object file 
ldshread(3X): Idshread, ldnshread .... read an indexednamed section header of a common 
object file 
.. seek to an indexednamed section of a common object file 
.. compute the index of a symbol table entry ofa 
common object file 
.. read an indexed symbol table entry of a common object file 
seek to the symbol table of a common object file 


ldsseek(3X): ldsseek, ldnsseek 
ldtbindex(3X) 


ldtbread(3X) 
ldtbseek(3X) 


logname(3X) .... .. return login name of user 
malloc(3X): malloc, free, realloc, 
calloc, mallopt, mallinfo ......scsecsesseses fast main memory allocator 


ndbm(3X): dbm_open, dbm_close, 
dbm_fetch, dbm_store, 
dbm_delete, dbm_firstkey, 
dbm_nextkey, dbm_error, 
dbm_clearerr, dmb_blkflush 
plot(3X) ..... 
putspent(3X) 
regemp(3X): regemp, regex 
sputl(3X): sputl, sgetl . 
utadduser(3X): ut_add_user, 

ut_delete_UBer .sccssssssescsseseeeeee add/delete users in utmp file 


.. database subroutines 

graphics interface subroutines 

write shadow password file entry 

compile and execute regular expression 

.. access long integer data in a machine-independent fashion 


4 File Formats 


intro(4) .. . introduction to file formats 


a.out(4) .. common assembler and link editor output 
acct(4) .... .. per-process accounting file format 
addusr_def(4) add user defaults 

alias(4) alias file for FACE 


ar(4) ... see C and Language Tools Binder 
backup_codes(4) . backup cycle code definitions 
backup_codes1(4) backup subcode definitions 
backup_dev(4) .... .. backup devices 

backup_info(4) .. backup set definitions 

cftime(4) ... language specific strings 
checklist(4) list of filesystems processed by fsck and ncheck 
constab(4) constructed devices table 

core(4) ... format of core image file 

cpio(4) .... format of cpio archive 

cronlog(4) . cron history file 

crontaba(4) ... ... Clock daemon file 

devtab(4) .. Virtual device table 
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. format of directories 

. file system independent directory entry 
. disk device characteristic database 

. incremental dump format 

. FACE files 


dump(4): dump, dumpdates 
env(4): environ, .pref, .variables 
errorlog(4) .... . internal error log file 

errormsg(4) . error message text file 

filehdr(4) ...... . file header for common object files 
fs(4): fs, inode . format of file system volume 


fapec(4) ..... . format specification in text files 

fstab(4) . . file-system-table 

gettydefs(4) .. speed and terminal settings used by getty 
gps(4): gps .. graphical primitive string, format of graphical files 
group(4) .... group file 

helplog(4) . .. monitor help actions 

init.d(4) .. system level transition files eames 
inittab(4) - script for the init process 

issue(4) . .. issue identification file 

Idfen(4) .. .. common object file access routines 

limits(4) file header for implementation-specific constants 
linenum(4) line number entries in a common object file 
loginlog(4) .. log of failed login attempts 

Iptypes(4) .. .. table of printer types supported by the menu system 
mnttab(4) .... .. mounted filesystem table 

mod_config(4) . .. format of a module configuration file 

motd(4) . .. message-of-the-day file 

ott(4) ..... .. files that hold object architecture information 
passwd(4) password file 

plot(4) ....... .. graphics interface 

product(4) .. installed products file 

profile(4) ... .. setting up an environment at login time 
proto(4) .. prototype job file for at 

TOCA) creees .. reboot and shutdown command scripts 
resfile(4) .. format of RCS file 

reloc(4) .. relocation information for a common object file 
scecsfile(4) . .. format of SCCS file 

senhdr(4) .. .. section header for a common object file 
scr_dump(4) .. format of curses screen image file 

shadow(4) .. Testricted password file 

shells(4) ... .. Shell table 

shutdown(4) .. system shutdown information file 

spellhist(4) .. unmatched spelling words file 

sulog(4) .. log of substitute user events 

syms(4) ...00 common object file symbol table format 
sys_config(4) format of a system configuration file 
syskeymap(4) identify keys to internal menu system functions 
task(4) ..... global security table 

term(4) .. format of compiled term file 

termcap(4) .. terminal capability data base 

terminfo(4) .. .. terminal capability database 
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.. Set default system time zone 

.. file header for symbolic constants 
.. utmp and wtmp entry formats 

.. networking support files 


timezone(4) .. 
unistd(4) .... 
utmp(4): utmp, wtmp 
UUCP(A)  cesesereen sevacsneveces 


5 Miscellaneous 


intro(5) ... .. introduction to miscellany 
ascii(5) ... .. map of ASCII character set 
environ(5) . .. user environment 

fentl(5) .... .. file control options 

math(5) . .. math functions and constants 
prof(s) .... profile within a function 
regexp(5) regular expression compile and match routines 
stat(5) .... data returned by stat system call 
term(5) . .. conventional names for terminals 
types(5) . .. primitive system data types 
values(5) .. machine-dependent values 
vararga(5) . handle variable argument list 


7 Special Files 


intro(7) ... .. introduction to special files 

clone(7) .. .. open any minor device on a STREAMS driver 

cmpt(7) .. compatibility partitioning driver 

cn(7) ... .. pseudoconsole driver 

consmem(7): consmem, 8m, 88 console memory drivers 

congole(7) ... easinalilerices console interface 

kmmen(7): kMBmem, kMWmem .. MULITBUS memory 

1d0(7)  sssrsssseroecsssssssnscsssasssseconcsssssssnssosssoess STREAMS tty line discipline 

log(7) .. interface to STREAMS error logging and event tracing 


1p(7) ... .. Systech parallel line printer interface 
Ipmod(7) .. parallel printer canonical processing module 
mbad(7) .. .. MULITBUS adapter 


mem(7); mem, kmem 

mtio(7) ... .. UNIX magnetic tape interface 

null(7) .... .. the null file 

PMAPT) cesscssescssenorsseneen .. map physical addresses into processs virtual address 
space 

.. devices administered by System Administration 

.. SCSI/Ethernet/Diagnostics board 

.. SCSI disk controller 

. STREAMS pipe device 

.. System Services Module 

.. Systech MTI-800/1600/1650 terminal multiplexor driver 

. STREAMS ioct] commands 

.. STREAMS pseudo terminal driver 

.. Generic STREAMS tty driver interface 

. general terminal interface 

.. SCSI 1/2-inch magnetic tape interface 


.. core memory 


tg(7)  csoovee 
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timod(7) .... .. Transport Interface cooperating STREAMS module 
tirdwr(7) . Transport Interface read/write interface STREAMS module 
tm(7) . .. SCSI tape controller 


. SCSI tape controller 

. controlling terminal (gentty) interface 

. 82-bit microsecond counter 

. VIOC partitioning driver 

. SSM SCSI disk controller 

. SSM parallel line printer interface 

. Xylogics 781 terminal multiplexor driver 

. Xylogics 472 MULITBUS magnetic tape interface 
. dual-channel disk controller 


ts(7) .. 


. introduction to system standalone utilities 

. standalone embedded SCSI disk formatter 

. run a standalone program or bring up the operating 
system 


cesformat(8) . 
boot(8) 


copy(8) .. . perform a standalone data transfer 

dump(8) . standalone memory dump 

prtvtoc(8) . . print the VTOC of a standalone disk device 

zdformat(8) .. standalone disk formatter for dual-channel disk controller 
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st: Systech MTI-800/1600/ 

hpio: Hewlett-Packard 

of DASI 300 and 300s terminals 
handle special functions of DASI 
DASI 300 and 300sterminals 300, 
special functions of DASI 300 and 
usclk: 

dis386: disassemble Series 

DASI 450 terminal 

handle special functions of the DASI 
xt: Xylogics 

between long integer and base- 

xs: Xylogics 

integer and base-64 ASCII string 


abs: return integer 

fabs: floor, ceiling, remainder, 
t_accept: 

requests 

utime: set file 

touch: update 

file 

initgroups: initialize group 
setgroups: set group 
machine-independent/ sputl, sgetl: 
ldfen: common object file 
endutent, utmpname, getutpid: 
access: determine 

acct: enable or disable process 
acctcon1, acctcon2: connect-time 
acctprel, acctpre2: process 
turnacct: shell procedures for 
runacct: run daily 

/accton, acctwtmp: overview of 

of accounting and miscellaneous 
diskusg: generate disk 

acct: per-process 

acctcom: search and print process 
acctmerg: merge or add total 
command summary from per-process 
fwtmp, wtmpfix: manipulate connect 
accounting 

format 

per-process accounting records 
accounting files 

accounting 
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1650 terminal multiplexor driver.. 
2645A terminal tape file archiver... 
300, 300s: handle special functions 
300 and 300s terminals. 
300s: handle special functions o: 
3008 terminals.......sscsseesssenes 


32-bit microsecond counter... usclk(7) 
386 instructions.........00000 
450: handle special functions of the... 450(1) 


450 terminal .....cccsssssssssssseessnesesseeneees 
472 MULITBUS magnetic tape interface 
64 ASCII string... scssasassesteees 
781 terminal multiplexor driver. 
a64l, ]64a: convert between long 
abort: generate an IOT fault....... 
abs: return integer absolute value.. 
absolute value. 
absolute value function 
accept a connect request... 
accept, reject: allow or prevent LP.. 
access and modification times. 
access and modification times of a file.. 


access: determine accessibility of a. vr vaccess(2) 
access list.. initgroups(3SEQ) 
access list... einer 


access long integer data ina 
ACCESB TOULINES....-se00000 
access utmp file entry. 


accessibility of a file... access(2) 
BCCOUNLING ..ecssecssscsssscecverersrernceesessasscesasnsescsnscoceserares soeeeecct(2) 
accounting acctcon(1M) 
accounting. acctpre(1M) 
acctsh(1M) 

runacct(1M) 

acct(1M) 

acct(1M) 


accounting data by user ID... diskusg(1M) 
accounting file format .acct(4) 
accounting files... .acctcom(1) 
accounting files... acctmerg(1M) 


accounting records. acctems(1M) 
ACcOUNtIN TECOTdS .....sesseesseeness fwtmp(1M) 
acct: enable or disable process -acct(2) 
acct: per-process accounting file. -acct(4) 
acctems: command summary from .acctems(1M) 


acctcom: search and print process. 
acctcon1, acctcon2: connect-time... 
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acctcon1, 
acctwtmp: overview of accounting/ 


of accounting and/ acctdisk, 
accounting files 
acctdisk, acctdusg, 
accounting 
acctprel, 
acctdisk, acctdusg, accton, 
release indication t_revrel: 
trig: sin, cos, tan, asin, 
helplog: monitor help 


sigaction: examine and change signal 
killall: kill all 

offline_all: take all but one 
mbad: MULITBUS 

addcmdopt: 

addformopt: 

addmenuopt: 

acctmerg: merge or 
addusr.def: 

putenv: change or 

menu 

ut_add_user, ut_delete_user: 
option to a menu 

menu 

hasmntopt, setmntent: get file/ 
map an open file into the processs 
munmap: unmap part of the processs 
addresses into processs virtual 
t_bind: bind an 

pmap: map physical 


menu 


files 

print service Ipfilter: 
print service lpforms: 
admin: create and 

SA: devices 


SA: devices administered by System 
sysadm: menu interface to do system 
uadmin: 

uadmin: 

swap: swap 

Ausr/ 

/onproc: run a command with priority 
alarm: set a process 


/display application specific 
pathalias: 

valloc: 

t_alloc: 

brk, sbrk: change data segment space 
free, realloc, calloc: main memory 


acctcon2: connect-time accounting 
acctdisk, acctdusg, accton,.... 
acctdusg, accton, acctwtmp: overview... 
acctmerg: merge or add total 
accton, acctwtmp: overview of accounting and/.....acct(1M) 
acctprel, acctpre2: process... acctpre(1M) 
acctpre2: process accounting... acctpre(1M) 
acctwtmp: overview of accounting and/.......00 acct(1M) 
acknowledge receipt of an orderly. .-t_revrel(3N) 
acos, atan, atan2: trigonometric/.. 
actions... 
actions.... 
active processe! 
active processor off line 
adapter... 
add a command option to a menu... 
add a form/SELECT window option to a 
add a menu option to a menu. 
add total accounting files. 
add user defaults.......... 
add value to environment... 

addcmdopt: add a command option to a... 
add/delete users in utmp file... 
addformopt: add a form/SELECT window.. “addformopt( 1M) 
addmenuopt: add a menu option to 4.......addmenuopt(1M) 
addmntent, endmntent, getmntent,.. getmntent(3SEQ) 


sigaction(2) 
sad killall(1M) 
-offline_all(3SEQ) 


address space... .»mmap(2SEQ) 
address space... munmap(2SEQ) 
AAATESE BPACC....scsesesssesesseseresseenssnenessessanensensenenesassnees pmap(7) 


address to a transport endpoint. .t_bind(3N) 
addresses into processs virtual address space pmap(7) 
addusr.def: add user defaults. antaseaneveees addusr_def(4) 
admin: create and administer A 
administer filters used with the LP.. 
administer forms used with the LP 


administer SCCS files .....scssesecseseree admin(1) 
administered’ by System Administration sa(7) 
Administration... .8a(7) 
administration... wsysadm(1) 


administrative control. 
administrative control.. 
administrative interface.. 
adm/loginlog: log of failed login attempt: 
aging, PFF, swapping, or processor/ 
alarm clock.. 
alarm: set a process alarm 


..uadmin(1M) 


“loginlog(4) 
.-noage(1M) 
-alarm(2) 
.alarm(2) 


alarms and/or the working indicator. -indicator(1F) 
alias file for FACE...sscssssssssssessssssssenssnessensansansaneasenenster alias(4) 
aligned memory allocator. -valloc(3SEQ) 
allocate a library structure. .t_alloc(3N) 
AllOCAtION.......scssssceesssescecssceserssseeessenscnestsoeessestsrenecseeeteese brk(2) 
allocator... -malloe(3C) 
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mallopt, mallinfo: fast main memory 
shrealloc, shfree: shared memory 
valloc: aligned memory 

editor output 

to maintenance commands and 

the working/ indicator: display 
lookup 


and libraries 

be: 

ott: files that hold object 

cpio: format of cpio 

the archive header of a member of an 
‘ ar: common 
ldahread: read the 
2645A terminal tape file 
tar: tape file 

cpio: copy file 

varargs: handle variable 
print formatted output of a varargs 
xargs: construct 

getopt: get option letter from 

echo: echo 

expr: evaluate 

message: puts its 

be: arbitrary-precision 

asa: interpret 

characters 

Aocaltime, gmtime, asctime, cftime, 
ascii: map of 


archive file 


between long integer and base-64 
ctime, localtime, gmtime, 

trig: sin, cos, tan, 

as: common 

a.out: common 


assert: verify program 

system commands 

/program for generating/modifying 
assist: 

generating/modifying ASSIST menus/ 
later time 

trig: sin, cos, tan, asin, acos, 

/sin, cos, tan, asin, acos, atan, 
double-precision number strtod, 
strtol, atol, 

strtol, 

change login password and password 

control over various process 

res: change RCS file 

dumpconf: dump kernel 
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allocator... 
allocator... 
AllOCALOT.......e.eeee0e 
a.out: common assembler and link 
application programMB......scecrsess 
application specific alarms and/or 


.indicator(1F) 


apropos: locate commands by keyword. .apropos(1) 
ar: archive file format.............8ee C and Lang Tools Binder 
ar: maintain archives... 


..8ee C and Lang Tools Binder 
arbitrary-precision arithmetic language a 
architecture information......... 


archive file format .. 
archive header of a member Of aN .......ssseeeeesee 


archives in and out 
argument list... 
argument list... 
argument list(s) and execute comman 
argument vector.. 
ATZUMENEB....erreeee 
arguments as an expression 
arguments on message line 
arithmetic language .......00 
ASA carriage control characters. 
asa: interpret ASA carriage contro! 
ascftime, mktime, tzset: convert... 
ASCII character set ....sssecvees —— 
ascii: map of ASCII character se! 
ASCII string. 
asctime, cftime, ascftime, mktime, tzset’/.. ctime(3C) 
asin, acos, atan, atan2: trigonometric/ ..trig(3M) 
ASSEMDIET.......c0ceereee ansuipanaisesaaes see C and Lang Tools Binder 
assembler and link editor output.. 
assert: verify program assertion. 


w"getopt(3C) 
»echo(1) 


ascii(5) 
..8641(3C) 


assist: assistance using operating 
ASSIST menus or command forma... 
assistance using operating system commands. 
astgen: program for. 
at, batch: execute commands at a 
atan, atan2: trigonometric functions 
atan2: trigonometric functions... 
atof: convert string tO... 
atoi: convert string to integer. 
atol, atoi: convert string to integer... 
attributes 
attributes 
attributes... 
auto-configuration device table. 
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language 

backup.codes: 

backup.dev: 

ckbupscd: check filesystem 
backup.info: 
backup.codes1: 

definitions 

definitions 


m_syne: check in at 
initialize barrier, wait at 
/3_wait_barrier: initialize 
of pathnames 

at, 

language 

procedures 


bessel: j0, j1, jn, yO, y1, yn: 
Bessel functions 


fread, fwrite: 

bp: 

bsearch: 

tfind, tdelete, twalk: manage 
tmp_affinity: 

t_bind: 

sum: print checksum and 

prtvtoc: print the VTOC ofa 
sigprocmask: examine and change 
number of blocks and indirect 
nblocks: calculate number of 

df: report number of free disk 
consistency check based on the 
consistency check based on the BOM 
bootflags: display/change system 
installboot: installs a 

bring up the operating system 
boot flags 


allocation 

segment size 

table 

stdio: standard 
setbuf, setvbuf: assign 
mailbug: submit a 
devbuiid, devdestroy: 
secstorcs: 

mknod: 


awk: pattern scanning and processing. 

backup cycle code definitions. ..backup_codes(4) 
backup devices.... ..backup_dev(4) 
backup schedul ckbupscd(1M) 
backup set definitions. -backup_info(4) 
backup subcode definitions... backup_codes1(4) 
backup.codes: backup cycle code .-backup_codes(4) 


backup.codes1: backup subcode... 
backup.dev: backup devices... 
backup.info: backup set definitions... 
banner: make posters. 
barrier... 
barrier.... 
barrier, wait at barrier 
basename, dirname: deliver portions. 
batch: execute commands at a later time 
be: arbitrary-precision arithmetic 
bcheckre: system initialization 
bdflush: update daemon... 
bdflush: update daemon. 
bdiff: big diff... 
Bessel functions... 
bessel: jO, jl, jn, yO, yl, yn:... 


backup_codes1(4) 
..backup_dev(4) 
-backup_info(4) 
»banner(1) 
..m_synce(3PPS) 
s_wait_barrier(3PPS) 
s_wait_barrier(3PPS) 
.-basename(1) 


-bessel(3M) 
-bessel(3M) 


bfs: big file scanner.... »bfs(1) 
binary input/output. fread(3S) 
binary patcher......... bp(1M) 


binary search a sorted table 


binary search trees... ..tsearch(3C) 
bind a process to a processo tmp.affinity(2SEQ) 
bind an address to a transport endpoint.. .t_bind(3N) 


block count of a file. +.Sum(1) 
block device .. prtvtoc(1M) 
blocked signals sigprocmask(2) 
Docks ......ceeeeee -nblocks(3SEQ) 
blocks and indirect blocks. -nblocks(3SEQ) 
blocks and inodes...cssssesssssssesessessseerrssscesesresensesererecerenes df{1M) 

-bomverify(1M) 

.bomverify(1M) 
DOO flAgGS.....sssessecceerserees .bootflags(1M) 
boot program on a disk... installboot(1M) 
boot: run a standalone program or. ..-boot(8) 
bootflags: display/change system ootflags(1M) 
bp: binary patcher.....ssesssssescesereeneen -bp(1M) 


brk, sbrk: change data segment space.. 
brk, sbrk: change private data... 
bsearch: binary search a sorted. 
buffered input/output package 
buffering to a stream........... aia 


~"brk(3PPS) 
search(3C) 
...-Stdio(3S) 
..setbuf(3S) 


bug report or enhancement request. -mailbug(1) 
build and destroy virtual devices... devbuild(1M) 
build RCS file from SCCS file scecstorcs(1) 
build special file ...mknod(1M) 
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config: 

swab: swap 

oe 

cflow: generate 


exref: generate a 

ctrace: 

list: produce 

indirect blocks nblocks: 
dc: desk 
cal: print 


stat: data returned by stat system 
syscall: indirect system 

cu: 

malloc, free, realloc, 

malloc, free, realloc, 

introduction to Sequent system 
intro: introduction to system 

Ip, cancel: send/ 

LP print service lp, 
lpmod: parallel printer 
description into a terminfo/ 

asa: interpret ASA 


gence: create a front-end to the 
disk formatter 


an SCCS delta 
remainder, absolute value/ floor, 
floor, ceil, fmod, fabs: floor, 


ctime, localtime, gmtime, asctime, 


sigprocmask: examine and 
brk, sbrk: 
passwd: 
chmod: 
chmod: 
putenv: 
chown: 
chown, chgrp: 
nice: 

brk, sbrk: 
res: 

chroot: 
chroot: 


attributes 
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(oJ flowgraph = .see C and Lang Tools Binder 


C language preprocessor........see C and Lang Tools Binder 
; C program beautifier... .see C and Lang Tools Binder 
C program checker... .see C and Lang Tools Binder 
C program cross-reference.....see C and Lang Tools Binder 


C program debugger. 
C source listing... 
cal: print calendar... 
calculate number of blocks and... 
calculator... 


.see C and Lang Tools Binder 
..bee C and Lang Tools Binder 


call another UNIX system... 
calloc: main memory allocator 
calloc, mallopt, mallinfo: fast main memory/.....malloc(3X) 
oe 


calls and error numbers 
cancel requests to the LP print service.. 
cance]: send/cancel requests to the. 
canonical processing module... 
captoinfo: convert a termcap. 
carriage control characters... 
cat: concatenate and print files... 
cb: C program beautifier 
cc command...... 
cc: C compiler see C and Lang Tools Binder 
CCSformat: standalone embedded SCSI...........cesformat(8) 
cd: change working directory...........00« a 

cde: change the delta commentary of. 
ceil, fmod, fabs: floor, ceiling,......... 
ceiling, remainder, absolute value/ 
cflow: generate C flowgraph...see C and Lang Tools Binder 
cftime, ascftime, mktime, tzset:/. i 
cftime: language specific strings 
change blocked signal s...........000+8 
change data segment space allocation.. 
change login password and password 
change mode....... Cn 
change mode of file. 
change or add value to environment.. 
change owner and group of a file. 
change owner or group......... 
change priority of a process. 
change private data segment size. 
change RCS file attributes... 
change root directory........ 
change root directory for a command. 
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shbrk, shsbrk: 

sigaction: examine and 
bootflags: display/ 

shutdown: shut down system, 


rename: 
delta: make a delta ( 


parameters vm_ctl: examine and 
cd: 

chdir: 

pipe: create an interprocess 

zd: dual- 

standalone disk formatter for dual- 
strstr: find first occurrence of 
ungetc: push 


conversion tables _chrtbl: generate 
_tolower, _toupper, setchrclass: 
cuserid: get 

getc, getchar, fgetc, getw: get 
pute, putchar, fputc, putw: put 
ascii: map of ASCII 

fgrep: search a file for a 

diskinfo: disk device 

asa: interpret ASA carriage control 
_tolower, toascii: translate 

tr: translate 

lastlogin, monacct, nulladm/ 


filesystem directory consistency 
filesystem storage consistency 
checkfeys: 

fack: filesystem consistency 
perform an installation consistency 
checkeq: 
ckbupscd: 
m_sync: 

ci: 

co: 
uucheck: 
eqn syntax. 


permissions file 


processed by fack and ncheck 

sum: print 

chown, 

/m_rele_procs: suspend and resume 
times: get process and 

wait, waitpid: wait for a 
m_get_numprocs: return number of 
m_kill_procs: kill 

m_set_procs: set number of 


: change the format of a text file... 
: change the Help Facility database. 


change shared data segment SIZE .......-s:scseeseres shbrk(3PPS) 


change signal actions. ...Sigaction(2) 
change system boot flags... bootflags(1M) 
change system state ..shutdown(1M) 


change the delta commentary of an SCCS delta.......... ede(1) 


change the name of a file. 
change) to an SCCS file..... 
change virtual memory tuning.. 
change working directory ... 
change working directory 


channel disk controller. 
channel disk controller.. 


character back into input stream.. 
character classification and. 
character handling.... 
character login name of the use: 
character or word from a stream. 
character or word on a stream 
character set. 
character string .. 

characteristic database 


chargefee, ckpacct, dodisk,.. vaectsh( 1M) 


chdir: change working directory ...chdir(2) 
ChECK ..sesseoeee dcheck(1M) 
check..... 7 -icheck(1M) 
check a filesyste: eck fsys(1M) 
check and interactive repair .....soscsssssssseeeeeeserereneeee fsck(1M) 
check based on the BOM ..bomverify(1M) 
check documents for correct eqn syntax.. checkeq(1) 
check filesystem backup schedule ..ckbupsed(1M) 


check in at barrier........ 
check in RCS revisions... 
check out RCS revisions... 
check the uucp directories and... 
checkegq: check documents for correct... 
check fsys: check a filesystem.. 
checklist: list of filesystems... 


checksum and block count of a file -.sum(1) 
chgrp: change owner or group or “chown(1) 
child process execution .m_park_procs(3PPS) 

..times(2) 


child process times......... 
child process to stop or terminate. 
child processes.... 
child processes 
child processes... 


aa. Wait(2) 
.m_get_numprocs(3PPS) 
.m_kill_procs(3PPS) 
..m_set_procs(3PPS) 
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file 


command 
classification and conversion/ 


schedule 
nulladm, pretmp/ chargefee, 
chrtbl: generate character 


clri: 

ferror, feof, 

a shell (command interpreter) with 
alarm: set a process alarm 
usclk_init: get/init microsecond 
cron: 


crontabs: ° 


STREAMS driver 
ldclose, ldaclose: 
close: 

t_close: 


felose, fiush: 
/telldir, seekdir, rewinddir, 


driver 


communicate to a/ cocreate, cosend, 
coreceive, codestroy: communicate/ 
backup.codes: backup cycle 

m_multi: mark single-process 
/cosend, cocheck, coreceive, 


to form error log dmesg: 
setcolor: redefine or create a 


comb: 

to two sorted files 

mcs: manipulate the object file 
cde: change the delta 

aout: 

ldclose, Idaclose: close a 

ldfhread: read the file header of a 
number entries of a section of a 
to the optional file header of a 
relocation entries of a section of a 
indexednamed section header of a 
to an indexednamed section of a 
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chmod: change mode......... 
chmod: change mode of file 
chown: change owner and group of a. 
chown, chgrp: change owner or group 
chroot: change root directory........+«. 
chroot: change root directory for a... 
chrtbl: generate character... 


Ci: check in RCS revisionS.......sssssessssscsscsssessssssesessscersrsses! ci(1) 
ckbupscd: check filesystem backup. ..ckbupscd(1M) 
ckpacct, dodisk, lastlogin, monacct, ...acctsh(1M) 


classification and conversion tables. 


clock: report CPU time used.. 
clone: open any minor device on a. 
close a common object file. 
close a file descriptor... 
close a transport endpoint. 
close: close a file descriptor.. 
close or flush a stream....... 
closedir: directory operations 
clri: clear inode.........6 bey 
cmp: compare two file: 
cmpt: compatibility partitioning: 
cn: pseudoconsole driver...... 
co: check out RCS revisions... 
cocheck, coreceive, codestroy: 
cocreate, cosend, cocheck,.. 
code definitions 
code section...... 
codestroy: communicate to a process 
col: filter reverse line-feeds.. 
collect system diagnostic me 
COLOR Scscsssssssvaccincsntsecaesssatsaresens 
comb: combine SCCS deltas. 
combine SCCS deltas........s.00 
comm: select or reject lines common.. 
COMMENE SECCION.....c.sesersssereeneers 
commentary of an SCCS delta. 
common assembler and link editor output.. 


common object file.. 
common object file... 
common object file... 
common object file.. 
common object file... 
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ae Leet EEE 


index of a symbol table entry of a 

an indexed symbol table entry of a 
seek to the symbol table of a 
linenum: line number entries in a 
reloc: relocation information for a 
scnhdr: section header for a 

ldfen: 

ldopen, Idaopen: open a 

/manipulate line number entries of a 
ldgetname: retrieve symbol name for 


syms' 
filehdr: file header for 
glossary: definitions of 
comm: select or reject lines 
cocheck, coreceive, codestroy: 
ipes: report inter-process 

stdipe: ftok: standard interprocess 
tfipe: interprocess 
infocmp: 

resdiff: 

cmp: 

secsdiff: 

diff: differential file 
diff3: 3-way differential file 
dircmp: directory 

cmpt: 

regemp: regular expression 
regcemp, regex: 

regexp: regular expression 

term: format of 

ce: C 

ec: forms 

tic: terminfo 

yacc: yet another compiler- 

yacc: yet another 

erf, erfc: error function and 

cprs: 

compress, uncompress, zcat: 

pack, peat, unpack: 

and expand data 

entry of a common object/ Idtbindex: 
cat: 

test: 

files 

pathconf, fpathconf: get 

sysconf: get 

dumpconf: dump kernel auto- 
mod_config: format of a module 
sys_config: format of a system 
config: build system 

showcfg: show the 

Tpadmin: 


symbols 


descriptions 


: common object file symbol table format. 


common object file 
common object file... 
common object file... 
common object file.. 
common object file... 
common object file... 
common object file access routines 
common object file for reading... 
common object file function... 
common object file symbol table/.. 


common object files 
common operating system terms and. 
common to two sorted files..... 
communicate to a process.... 
communication facilities status 
communication package... 
communication reporter... 
compare or print out terminfo. 
compare RCS revisions. 
compare two files 
compare two versions of an SCCS file.. 
comparison.. 
comparison... 
comparison...... 
compatibility partitioning driver. 
COMPILE....srervsrerveereerseses scvevecsdvaatarea 
compile and execute regular expression 
compile and match routines. 
compiled term file... 


compiler..... see C and Lang Tools Binder 
compiler. ..ec( 1M) 
compiler ..tic(1M) 


compiler.... acc(1) 
compiler-compiler. ace(1) 
complementary error fUNCtION.........sessseareseeen .erf(3M) 
compress an object file. see C and Lang Tools Binder 


compress and expand data.. .compress(1) 
compress and expand files... 
compress, uncompress, zcat: compres: 


compute the index of a symbol table.. 


.compress(1) 
..1dtbindex(3X) 


concatenate and print files........ssssssesssecesseencerserenenrene cat(1) 
condition evaluation command.. .test(1) 
config: build system configuration. config(1M) 
configurable pathname variables .-pathcon{(2) 
configurable system variables syscon{{2) 
configuration device table . dumpconf{(1M) 


configuration file... -mod_config(4) 
configuration file. 
configuration files. 
configuration of the machine. 


configure the LP print service 
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t_revconnect: receive the 

fwtmp, wtmpfix: manipulate 
t_accept: accept a 

t_listen: listen for a 

receive the confirmation from a 
establish an out-going terminal line 
data or expedited data sent over a 
send data or expedited data over a 
t_connect: establish a 

acctcon1, acctcon2: 

dcheck: filesystem directory 
icheck: filesystem storage 

feck: filesystem 

bomverify: perform an installation 
quotacheck: filesystem quota 
drivers 


console: 
consmem, 8m, 88: 


read_constab: read 

header for implementation-specific 
math: math functions and 

unistd: file header for symbolic 
constab: 

deroff: remove nroff, tbl, and eqn 
Uutry: try to 

1s: list 

sigcontext: get signal 

set and/or get signal stack 

csplit: 

sd: SCSI disk 

tm: SCSI tape 

ts: SCSI tape 

wd: SSM SCSI disk 

zd: dual-channel disk 

disk formatter for dual-channel disk 
synchronize a co-process with the 


virtually hangup the specified 

tty: 

_tolower, toascii: translate/ 

units: 

character classification and 

terminfo description captoinfo: 
dd: 

long integers 18tol, ltol3: 
base-64 ASCII string a64l, 164a: 


dev_to_ttyname, ttyname_to_dev: 
/cftime, ascftime, mktime, tzset: 


DYNIX/ptx Reference Manual 


§ convert formatted input........csssssssesssssees 
convert string to double-precision number... 


.t_revconnect(3N) 
....fwtmp(1M) 


confirmation from a connect request 
connect accounting records .. 


connect request... accept(3N) 
connect request... ..t_listen(3N) 
connect request... .t_revconnect(3N) 
COTMECHION ..sevrsssceserecnsseenenensecenessnesssssscsesssonensnroraneseses dial(3C) 


connection. 
connection 
connection with another transport user.. 
connect-time accounting... 
consistency check... 
consistency check ... 
consistency check and interactive repair. 
consistency check based on the BOM 
consistency checker 
consmem, sm, 8s: console memory 
console: console interface 
console interface........0+ 
console memory drivers 
constab: constructed devices table. 
constab entries into a structure 


CODBEIUCEES erscecrsessersererees 
contact remote ayatem with debugging on. 
contents of directory. 
context... 
context... 
context split 
controller. 


controller. 
controller... 


controlling obje 


conversion program... 
conversion tables...... 
convert a termcap description into a... captoinfo(1M) 
Convert and COpy B file....sccssccsosssesesresrsenssecnenenereeeeesonees dd(1M) 
convert between 3-byte integers and.. .13tol(3C) 
convert between long integer and. -8641(3C) 
convert major/minor numbers... dev_to_ttyname(3C) 
convert date and time to string.. i 
convert floating-point number to string .. 


Permuted Index 


strtol, atol, atoi: 
password file scheme pwunconv: 
vsig: synchronize a 
UNIX-to-UNIX system 
system file 

dd: convert and 
cpset: 

cpio: 

cp, In, mv: 

volcopy: make literal 
transfer 


savecore: save & 


core: format of 

mem, kmem: 

and unset environment variables in 
cocreate, cosend, cocheck, 

checkeq: check documents for 
trigonometric functions trig: sin, 
codestroy: communicate to/ cocreate, 
sinh, 

we: word 

sum: print checksum and block 
m_next: increment global 

usclk: 32-bit microsecond 


cpio: format of 


and group IDs 

clock: report 

cpus_online: returns the number of 
CPUs on-line 


an existing one 
setcolor: redefine or 
gence: 

tmpnam, tempnam: 
creat: 

fork: 

ctags: 

tmpfile: 

pipe: 

admin: 

tasktbl: 

setsid: 

pathconv: search Interpreter 


cronlog: 
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Convert string to Integer .......ccsccssececesceeesnensseeeceseees strtol(3C) 
converts from a two to a one ....pwunconv(1M) 
co-process with the controlling FMLI object. 
copy ... 
Copy... 
copy a file. 
copy file and set mode, user, and group IDs 
copy file archives in and out 
copy, link or move files 
copy of filesystem......... 
copy: perform a standalone data. 
core dump of the operating system.. 
core: format of core image file.. 
core image file 
core memory... 


..volcopy(1M) 
sascaet copy(8) 
savecore(1M) 


core or in files.... .set(1F) 
coreceive, codestroy: communicate to “coproc(1F) 
COTTECt EQN BYNLAX...ssssessseceseesees: .checkeq(1) 


cos, tan, asin, acos, atan, atan2: 
cosend, cocheck, coreceive, 
cosh, tanh: hyperbolic functions... 
COUN... recereees 


.coproc(1F) 
sinh(3M) 
+ we(1) 


count of a file. .8um(1) 
counter... -m_next(3PPS) 
counter... ..usclk(7) 
cp, In, mv: copy, link or move files.. +¢p(1) 
cpio archive ........+. sastaavaseasstvanstacan +»cpio(4) 


cpio(1) 
w1.Cpio(4) 


cpio: copy file archives in and out 
cpio: format of cpio archive......... 
cpp: C preprocessor... see C and Lang Tools Binder 
cprs: compress object file. .see C and Lang Tools Binder 
cpset: copy file and set mode, user, . 
CPU time used....essesssseesesesseneereeneee 
CPUS OD-]INE....sscssecseserssecensecacseerenes 
cpus_online: returns the number o. 
crash: examine system images.... 
creat: create a new file or rewrite 
CTEALE B COLOT...cosesereseeeesesssesecnseroren 
create a front-end to the cc : command. 
create a name for a temporary file... 
create a new file or rewrite an existing one. 
create a new process.. 
create a tags file........ 
create a temporary file 
create an interprocess channel.... 
create and administer SCCS files. 
create security table in shared memory: 
create session and set process group ID. 
criteria for filename. 
cron: clock daemon 
cron history file.. 
cronlog: cron history file. 


.cpus_t online(3PPS) 
.cpus_online(3PPS) 
.crash(1M) 
eel creat(2) 
..setcolor(1F) 
.gence(1M) 
.tmpnam(3S) 
..creat(2) 


..tasktbl(1M) 
.--8etsid(2) 
pathconv(1F) 
..cron(1M) 
..cronlog(4) 
..cronlog(4) 
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crontab: user 


exref: generate C program 
pg: file perusal filter for 


functions 
hashing encryption 
with C-like syntax 


terminal 
cftime, ascftime, mktime, tzset/ 


scr_dump: format of 
optimization package 

the user 

line of a file 

cut: 

cross-reference 
backup.codes: backup 
bdflush: update 

bdflush: update 

cron: clock 

strerr: STREAMS error logger 
crontabs: clock 
pwdhd: 
runacct: run 
300s: handle special functions of 
450: handle special functions of the 
zcat: compress and expand 

prof: display profile 

time a command; report process 
termcap: terminal capability 
diskusg: generate disk accounting 
t_revuderr: receive a unit 

sputl, sgetl: access long integer 
plock: lock process, text, or 

t_snd: send 

t_rev: receive 

t_snd: send data or expedited 
stat: 

brk, sbrk: change private 

shbrk, shsbrk: change shared 
brk, sbrk: change 

t_rev: receive data or expedited 
copy: perform a standalone 

types: primitive system 
t_revudata: receive a 


creation 


t_sndudata: send a’ 
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Permuted Index 


crontab file .crontab(1) 
crontab: user crontab file. 
crontabs: clock daemon file... 


cross-reference 


crypt: encode/decode.. 
crypt: password and file encryption... 
crypt, setkey, encrypt: generate... 
csh: a shell (command interpreter) 
csplit: context split........ saauaaneasisenas 
ct: spawn getty to a remote terminal. 
ctags: create a tags file........00 
ctermid: generate filename for 
ctime, localtime, gmtime, asctime,. 
ctrace: C prog debugger..........see C and Lang Tools Binder 
cu: call another UNIX system.. .cu(1C) 
curses screen image file....... ..8cr_dump(4) 
curses: terminal screen handling and.. oH 

cuserid: get character login name of.. 
cut: cut out selected fields of each... 


daily accounting......sssersceere 

DASI 300 and 300s terminals.. 
DASI 450 terminal... 
data... 


AEA .ssssccccessescccesnssecsncconessasssonssnsasssconsonnsseseaseassssensansassoues prof(1) 
data and system activity... timex(1) 
termcap(4) 

diskusg(1M) 

__revuderr(3N) 

data ina machine independent sput](3X) 
data in MEMOTY.....csscvssseessssneseessee plock(2) 
data or expedited data over a connection t_snd(3N) 
data or expedited data sent over a connection.....t_rcv(3N) 


data Over & CONNECHION......csseececee 
data returned by stat system call. 
data segment size... 
data segment size.. 
data segment space allocation 
data sent over a connection 
data transfer.......c.csssssscse 


at, pevudata(3N) 
t_sndudata(3N) 
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Permuted Index 


diskinfo: disk device characteristic 
helpadm: change the Help Facility 
terminfo: terminal capability 

a terminal or query terminfo 
pwdhd: daemon to oversee password 
mkpwdbm: make a 

join: relational 

dbm_clearerr, dmb_blkflush: 
makewhatis: generate man page 
date: print and set the 

ascftime, mktime, tzset: convert 


/dbm_nextkey, dbm_error, 
dbm_delete/ dbm_open, 
dbm_close, dbm_fetch, dbm_store, 
/dbm_firstkey, dbm_nextkey, 
dbm_firstkey,/dbm_open, dbm_close, 
/dbm_fetch, dbm_store, dbm_delete, 
dbm_store, dbm_delete, dbm_firstkey, 
dbm_store, dbm_delete/ 

dbm_open, dbm_close, dbm_fetch, 
pdbx, 


. enable/disable patrol seeks on 
consistency check 


ctrace: C program 

pdbx, dbx: parallel 

try to contact remote system with 
crypt: encode/ 

timezone: set 

reset the current form field to its 
addusr.def: add user 

format disks or perform other 
gtty: set and get terminal state ( 
ut_add_user, ut_delete_user: add/ 
the delta commentary of an SCCS 
delta: make a 

cde: change the 

rmdel: remove a 

SCCS file 

comb: combine SCCS 

constructs 

whatis: 

close: close a file 

dup: duplicate an open file 

dup2: duplicate an open file 
setmntent: get file system 
getdtablemax: get maximum in-use 
getdtablesize: get 

setdtablesize: set 

de: 
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diskinfo(4) 
.-helpadm(1M) 
..terminfo(4) 


database creation 
database for fast password lookup.. 
database operator... 
database subroutines.. 


date and time to string 
date: print and set the date......cscssccsosrecesssersseeeess date(1) 
dbm_clearerr, dmb_blkfiush: database/. 
dbm_close, dbm_fetch, dbm_store,.. 
dbm_delete, dbm_firstkey,/... 
dbm_error, dbm_clearerr/.... 
dbm_fetch, dbm_store, dbm_delete, 
dbm_firstkey, dbm_nextkey,/. 
dbm_nextkey, dbm_error/.... 
dbm_open, dbm_close, dbm_fetch, .. 
dbm_store, dbm_delete, dbm_firstkey/. 
dbx: parallel debugger. .see C and Lang Tools Binder 


de: desk calculator .....ssssssssssssssssssesssersessveseressesseees sseeeee(1) 
DCC disks.......ssssessecsesseees ..sweepon(1M) 
dcheck: filesystem directory... .dcheck(1M) 


dd: convert and copy a file.. 


debugger... .see C and Lang Tools Binder 
debugger... .see C and Lang Tools Binder 
debugging on. 


uutry(1M) 


-addusr_def(4) 
.format(1M) 


MORNE) ccs cssnsscnsssseantensssainasicsionssesiosssacesadesassocacsoscasiesssees stty(2) 
delete users in utmp file. utadduser(3X) 
Aelta......scccsssscssssssecescecssssenssecscsvcnssncersececssenesvescanenssnsaseasons cde(1) 
delta (change) to an SCCS file... delta(1) 
delta commentary of an SCCS delta ..cde(1) 
delta from an SCCS file......sssessesees “rmdel(1) 


delta: make a delta (change) to a: 
deltas... 
deroff: rem 


descriptor file entry .getmntent(3SEQ) 
descriptor table inex, etdtablemax(2SEQ) 
descriptor table size. getdtablesize(2SEQ) 
descriptor table size setdtablesize(2SEQ) 
desk calculator...... wee de(1) 
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devbuild, devdestroy: build and 
destroy virtual devices 

virtual devices devbuild, 
ioctl: control 

prtvtoc: print the VTOC of a block 
print the VTOC of a standalone disk 
sp: STREAMS pipe 

or the terminal] associated with a 
theterminal/ _ttydevname: get the 
diskinfo: disk 

devnm: 

clone: open any minor 

devtab: virtual 

dump kernel auto-configuration 
backup.dev: backup 

build and destroy virtual 

of virtual-to-physical mapping 

SA: 


constab: constructed 


convert between major/minor numbers/ 
blocks and inodes 

dmesg: collect system 

SCED: scsi/Ethernet/ 

terminal line connection 

bdiff: big 


comparison 
sdiff: side-by-side 


diff: differential file comparison... 


diff3: 3-way 


dir: format of 

unlink: link and unlink files and 
rokdir: make 

rm, rmdir: remove files or 
uucheck: check the uucp 

cd: change working 

chdir: change working 

chroot: change root 

get pathname of current working 
system level transition files 

1s: list contents of 

mkdir: make a 

mvdir: move a 

rmodir: remove a 

uucleanup: uucp spool 

diremp: 

dcheck: filesystem 

system independent/ getdents: read 
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” devtab: virtual device table. 


destroy virtual devices...... ..devbuild(1M) 
devbuild, devdestroy: build and.. devbuild(1M) 
devdestroy: build and destroy.. devbuild(1M) 


.ttydevname(1) 
device associated with a terminal or .ttydevname(1) 
device characteristic database iski 
evice DAME.....ssereessssceeserersee 
device on a STREAMS driver 


device table.. 


device table... ‘dumpcontt 1M) 
devices -backup_dev(4) 
devices 

devices... 


devnm: device name.. 


dev_to_ttyname, ttyname_to_de 
df: report number of free disk..... 
diagnostic messages to form error log... 
Diagnostics board.........00008 
dial: establish an out-going. 
diff... 
diff: differential file comparison. 
diff: 3-way differential file. 
difference program.........+. 


differential file comparison... 
dir: format of directories.. 
dircmp: directory comparison. 
directories. 


directory. 
directory... 
directory clean-up... 
directory comparison. 
directory consistency check.. 
directory entries and put in a fil 


Permuted Index 


dirent: file system independent 
unlink: remove 

chroot: change root 

pwd: working 

telldir, seekdir, rewinddir/ 
seekdir, rewinddir, closedir: 
mknod: make a 

directory entry 

basename, 


instructions 

t_unbind: 

enable, 

enable, disable: enable/ 

sweepon, sweepoff: enable/ 

acct: enable or 

swapping, or processor migration 
dis386: 

dis: object code 

t_revdis: retrieve information from 

t_snddis: send user-initiated 

installs a boot program on a 

diskusg: generate 

df: report number of free 

ad: SCSI 

wd: SSM SCSI 

zd: dual-channel 

disk formatter for dual-channel 

print the VTOC of a standalone 

diskinfo: 

CCSformat: standalone embedded SCSI 
controller zdformat: standalone 

getgeombyname: get 

quotactl: manipulate 

du: summarize 

quota: display 

database 

mkvtoc: populate VTOC on 

enable/disable patrol seeks on DCC 

mgmt functions format: format 

data by user ID 

indicator: 

quota: 

vi: screen-oriented (visual) 

man: 

virtual-to-physical mapping/ pmap: 

prof: 

bootflags: 

hypot: Euclidean 


andW/or the working/ 


/dbm_error, dbm_clearerr, 
messages to form error log 
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directory entry.. 
directory entry. 
directory for a command... 
directory NAME... 
directory: opendir, readdir, . 
directory operations 
directory, or a special or ordinary file... 
dirent: file system independent......... 
dirname: deliver portions of pathnames.. 
dis: code disassembler............ see C and Lang Tools Binder 
dis386: disassemble Series 386. 
disable a transport endpoint... 
disable: enable/disable LP printers 
disable LP printers.......csssessssseese 
disable patrol seeks on DCC disks. 


disassemble Series 386 instructions. 
disassemble’.......ecsccsesssseesenees see C and Lang Tools Binder 
disconnect... t_revdis(3N) 
disconnect request.. .t_snddis(3N) 
installboot(1M) 
.diskusg(1M) 


disk accounting data by user ID. 


disk blocks and inodes «oe 1M) 
disk controller..... .8d(7) 
disk controller...... wd(7) 
disk controller... Z0(7) 
disk controller zdformat(8) 
disk device......... .-prtvtoc(8) 


disk device characteristic database... vdiskinfo(4) 
disk formatter ....ssssssssssscscneessensseees «ccsformat(8) 
disk formatter for dual-channel disk ~ zdformat(8) 
disk geometry by name.. getgeombyname(3SEQ) 
disk quotas.... quotactl(2SEQ) 
disk usage.... ..du(1M) 
disk usage and limits. “quota(1) 
diskinfo: disk device characteristic .diskinfo(4) 
disks... .««mkvtoc(1M) 
disks.... sweepon(1M) 
disks or perform other defect... format(1M) 
diskusg: generate disk accounting ..diskusg(1M) 


display application specific alarms indicator(1F) 


display disk usage and limits.. quota(1) 
display editor based on ex... wee Vi(1) 
display on-line man pages... man(1) 
display or alter parameters of. map{1M) 
display profile data.........sssssse .--prof(1) 
display/change system boot flags bootflags(1M) 
distance function ......ssssssers hypot(3M) 
ditsectbl: refresh security table. ditsectbl(1M) 


dmb_blkflush: database subroutin 
dmesg: collect system diagnostic. 
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checkeq: check 

pretmp,/ chargefee, ckpacct, 
strtod, atof: convert string to 
mrand48, jrand48, srand48, seed48,/ 
open any minor device on a STREAMS 
cmpt: compatibility partitioning 

cn: pseudoconsole 

terminal multiplexor 

streampty: STREAMS pseudo terminal 
vtoc: VTOC partitioning 

Xylogics 781 terminal multiplexor 
streamtty: Generic STREAMS tty 
consmem, 8m, 88: console memory 


zd: 

/standalone disk formatter for 
dump: incremental filesystem 

dump: standalone memory 

od: octal 

of an object file 

format 

dumpfs: 

dump, dumpdates: incremental 
device table dumpconf: 
savecore: save a core 


auto-configuration device table 
dump, 


descriptor 
descriptor 
dup: 
dup2: 


echo: 


floating-point number to string 


end, etext, 

command 

casual users) 

edquota: 

sact: print current SCCS file 

ed, red: text 

ex: text 

sed: stream 

vi: screen-oriented (visual) display 
1d: link 

a.out: common assembler and link 
edit: text 
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documents for correct eqn syntax....... 
dodisk, lastlogin, monacct, nulladm,, 
double-precision number . 
drand48, erand48, lrand48, nran 


.checkeq(1) 
.acctsh(1M) 
..8trtod(3C) 
.drand48(3C) 


empt(7) 

cn(7) 

.8t(7) 

streampty(7) 

»vtoc(7) 

+000X8(7) 

streamtty(7) 

consmem(7) 

du: summarize disk usage. du(1M) 
dual-channel disk controlle: ooeeZ0(7) 
dual-channel disk controller... zdformat(8) 
dump..... dump(1M) 
dump. dump(8) 
dump. ..0d(1) 
dump: dump parts, ..see C and ne Tools Binder 


dump, dumpdates: incremental dump. 
dump filesystem information 
dump format.......... Crt 
dump: incremental filesystem dump 
dump kernel auto-configuration..... 
dump of the operating system... 
dump: standalone memory dump. 
dumpconf: dump kernel.. 
dumpdates: incremental dump format... 
dumpfs: dump filesystem information. 
dup: duplicate an open file..... 
dup2: duplicate an open file.. 
duplicate an open file descriptor... 
duplicate an open file descriptor... 
ec: forms compiler. 
echo arguments... 
echo: echo arguments..... 
echo: put string on virtual output. 
ecvt, fevt, gcvt: convert 
ed, red: text editor....... 
edata: last locations in program.. 
ede: run an externally described... 
edit: text editor (variant of ex for 
edit user quotas... 
editing activity. 
editor... 


editor based on ex. 


editor for object files and Lang Tools Binder 
editor output. .a.out(4) 
editor (variant of ex for casual users). ..edit(1) 
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Permuted Index 


effective user, real group, and 
/getgid, getegid: get real user, 


feplit: split 77, ratfor, or 

using full regular expressions 
CCS format: standalone 

printers 

acct: 

enable, disable: 

sweepon, sweepoff: 

crypt: 

crypt, setkey, 

setkey, encrypt: generate hashing 
crypt: password and file 
makekey: generate 

program 

gence: create a front- 

/getgrgid, getgrnam, setgrent, 
setmntent: get file/ addmntent, 
bind an address to a transport 
t_close: close a transport 

at the current event on a transport 
t_open: establish a transport 
manage options for a transport 
t_unbind: disable a transport 
/getpwuid, getpwnam, setpwent, 
getspent, getspnam, setspent, 
/getutline, pututline, setutent, 
mailbug: submit a bug report or 
execution 

files 


environ: user 

putenv: change or add value to 
commands performed for multi-user 
profile: setting up an 

fpsetsticky: IEEE floating-point 

env: set 

getenv: return value for 

set, unset: set and unset 

deroff: remove nroff, tbl, and 
checkeq: check documents for correct 
jrand48, srand48, seed48/ drand48, 
complementary error function 
complementary error function _erf, 
error messages perror, 
error function and complementary 
error function erf, erfe: 
t_revuderr: receive a unit data 
system diagnostic messages to form 
errorlog: internal 
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edquota: edit user quotas .. ..edquota(1M) 
effective group IDB.....ss0000 -getuid(2) 
effective user, real group, and/. 


«getuid(2) 
efi: Extended Fortran Language.. on 
Of fil e8 &cccccseacsccecvescescosenssvassiesse 
egrep: search a file for a pattern 
embedded SCSI disk formatter... 
enable, disable: enable/disable L 
enable or disable process accounting. 
enable/disable LP printers.... 
enable/disable patrol seeks on 
CNCOde/dECOE....ssssersressenserseersnsesenenseren 
encrypt: generate hashing encryption.. 
ENCTYPION......s0s00000 
encryption functions 
encryption key. 
end, etext, edata: last locations in. 
end to the cc ComMANA......sssessseveee 
endgrent, fgetgrent: get group file entry... 
endmntent, getmntent, hasmntopt, 
endpoint.. 
endpoint... 


.t_bind(3N) 
t_close(3N) 


endpoint... .t_look(3N) 
ENAPOINE ...sessecssssessessssessusseceneneseseesenerossnssnesnsseesesonss t_open(3N) 
endpoint.. t_optmgmt(3N) 


endpoint... t_unbind(3N) 
endpwent, fgetpwent: get password file/........getpwent(3C) 
endspent, fgetspent, Ickpwdf//.......ss0 .getspent(3X) 


..getut(3C) 
mailbug(1) 
.env(1) 
-env(4) 
.environ(5) 
environ(5) 


endutent, utmpname, getutpid: access/, 
enhancement TequeSt.....ccsessersssesessseereereeees 
env: set environment for command 
.environ, .pref, .variables: FACE... 
environ: user environment 
environment... 
environment... 
environment... 
environment at login time 
environment control... 


environment for command eCxecution......scscsrsereeseees env(1) 
ENVITONMENt NAME ..eeseseesseceseeceseees getenv(3C) 
environment variables in core or in files. -8et(1F) 
eqn constructs .deroff(1) 
eqn syntax....... .checkeq(1) 


erand48, lrand48, nrand48, mrand48,. 
erf, erfc: error function and.. a 

erfc: error function and...... 
errno, sys_errlist, sys_nerr: system 
EYTOT FUNCION........scsessseseeneeneeseeeee 
error function and complementary. 
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strclean: STREAMS 

strerr: STREAMS 

log: interface to STREAMS 

t_error: produce 

errormsg: 

errno, sys_errlist, sys_nerr: system 
introduction to system calls and 
matherr: 


spellin, hashcheck: find spelling 
/etc/shadow with information from / 
pwconv: installs and updates / 
end, 

SCED: ScsV/ 

hypot: 

expr: 

test: condition 

t_look: look at the current 

to STREAMS error logging and 
sulog: log of substitute user 
(visual) display editor based on 
edit: text editor (variant of 


execlp, execvp: execute a file 
execlp, execvp: execute a/ exec: 
exec: execl, execv, 

exec: execl, execv, execle, execve, 
run: run an 

execle, execve, execlp, execvp: 
m_fork: 

construct argument list(s) and 

at, batch: 

regemp, regex: compile and 

uuxgt: 

env: set environment for command 
suspend and resume child process 
/system command 

sleep: suspend 

sleep: suspend 

monitor: prepare 

profil: 

execvp: execute a file exec: execl, 
exec: execl, execv, execle, 

execv, execle, execve, execlp, 


exit, 

exponential, logarithm, power/ 
uncompress, zcat: compress and 
pack, peat, unpack: compress and 
exp, log, log10, pow, sqrt: 
expression 
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error logger cleanup program. 
error logger daemon... 
error logging and event tracing 
CYTOL MCBSAZE......cs0ee00 
error message text file. 
error messages... 
error numbers... 
error-handling function. 
errorlog: internal error log file.. 
errormsg; error message text file 


strclean(1M) 
.strerr( 1M) 


..eTrormsg(4) 
aeaeael spell(1) 
etc/passwd ..pweonv(1M) 
etc/shadow with information from/. 
etext, edata: last locations in program... 
Ethernet/Diagnostics board... 
Euclidean distance function.. 
evaluate arguments as an expressio 
evaluation command.......s00 a 


event on a transport endpoint. 


event tracing... .-log(7) 
events. 

CXiensae -Vi(1) 
ex for casual users)... edit(1) 
ex: text editor........ +ex(1) 


exec: execl, execv, execle, execve, 
execl, execv, execle, execve,...... 
execle, execve, execlp, execvp: execute a file 
execlp, execvp: execute a file. 
executable... 


execute a file. exec(2) 
execute a subprogram in paralle: ..m_fork(3PPS) 
execute COMMANA....ssssseeeees cates .xargs(1) 


execute commands at a later time.. «oe t(1) 
execute regular expression... 


execute remote command requests 


O@XOCUEION eivisisesccaccssonessracscsasereesisccsacreicesesessvassbeenasesrnesiin env(1) 
execution.. 
execution... uux(1C) 


execution for an interval. 
execution for interval... 
execution profile... 
execution time profile.. 
execv, execle, execve, execlp, 
execve, execlp, execvp: execute a file... 
execvp: execute a file..........00++ 
exit, _exit: terminate process.. 
_exit: terminate process......... 


.exit(2) 
.exit(2) 


exp, log, log10, pow, sqrt: .exp(3M) 
expand data. ..compresa(1) 
expand files .. .-pack(1) 
exponential, logarithm, power, square/ 
expr: evaluate arguments as an......... rey 


Permuted Index 


expr: evaluate arguments as an 
regex: compile and execute regular 
regemp: regular 

regexp: regular 

for a pattern using full regular 


faplit: split 

floor, ceil, fmod, 

pathalias: alias file for 

.environ, .pref, .variables: 

report inter-process communication 
a number 

factor: obtain the prime 

true, 

abort: generate an IOT 

stream 


ecvt, 

fopen, freopen, 
ferror, 
stream status inquiries 

for a filesystem 

felose, 

from a stream getc, getchar, 
/getgrnam, setgrent, endgrent, 
/getpwnam, setpwent, endpwent, 
gets, 

/getspnam, setspent, endspent, 
string 

cut: cut out selected 

mokfifo: make a 

access: determine accessibility of a 
chmod: change mode of 

chown: change owner and group of a 
core: format of core image 

cronlog: cron history 

crontab: user crontab 

crontabs: clock daemon 

ctags: create a tags 

selected fields of each line of a 

dd: convert and copy a 

make a delta (change) to an SCCS 
errorlog: internal error log 
errormsg: error message text 
execve, execlp, execvp: execute a 
get: get a version of an SCCS 
group: group 

issue: issue identification 

header of a member of an archive 
Idaclose: close a common object 


number to string 
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: Extended Fortran Language 


expression... 
expression... 
expression compile.. 
expression compile and match routines.. 
expressions... 


externally described comman 
77, ratfor, or eff files... 

fabs: floor, ceiling, remainder, absolute value/. 
FACE... 
FACE file: 
facilities status. 
factor: obtain the prime factors of... 
factors of a numbet............ 


fclose, flush: close or flush a. 
fentl: file control... 
fent): file control options. 
fevt, gevt: convert floating-point. 
fdopen: open & BtFCAM......srsesessee 
feof, clearerr, fileno: stream status inquiries....... 
ferror, feof, clearerr, fileno:...... 
ff: list filenames and statistics. 
flush: close or flush a stream... 
fgetc, getw: get character or word... 
fgetgrent: get group file entry..... 
fgetpwent: get password file entry. 
fgets: get a string from & Stream ...sescseseessseseeseseees gets(3S) 
fgetspent, Ickpwdf, ulckpwdf: get/.. 
fgrep: search a file for a character. 
fields of each line of a file .. 
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the file header of a common object 
of a section of a common object 

file header of a common object 

of a section of a common object 
section header of a common object 
section of a common object i 

table entry of a common object ..ldtbindex(3X) 
table entry of a common object 

the symbol table of a common object 
number entries in a common object 
link: link to a 

mkfifo: make a FIFO special 

mknod: build special 

directory, or a special or ordinary 
format of a module configuration 
motd: message-of-the-day 

newform: change the format of a text 
null: the null 

passwd: password 

files or subsequent lines of one 
product: installed products 

prs: print an SCCS 

resfile: format of RCS 

read: read from 

readv: read vector from 

reinit: run an initialization 
information for a common object 
rename: change the name of a 
rmdel]: remove a delta from an SCCS 
compare two versions of an SCCS 
sccsfile: format of SCCS 

sccstorcs: build RCS file from SCCS 
section header for a common object 
format of curses screen image 
shadow: restricted password 
system shutdown information 
spellhist: unmatched spelling words 
print checksum and block count of a 
symlink: make symbolic link to a 
format of a system configuration 
tail: deliver the last part of a 

term: format of compiled term 
tmpfile: create a temporary 

create a name for a temporary 
access and modification times of a 
undo a previous get of an SCCS 
uniq: report repeated lines ina . 
add/delete users in utmp -utadduser(3X) 

the uucp directories and permissions 
val: validate SCCS 

write: write ona 

writev: write vector on @ 
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utime: set 

Idfen: common object 
readfile, longline: reads 
cpset: copy 

Hewlett-Packard 2645A terminal tape 
tar: tape 

cpio: copy 

res: change RCS 

pwek, grpck: password/group 
mcs: manipulate the object 
diff: differential 

diff3: 3-way differential 
fentl: 

fentl: 

UNIX-to-UNIX system 
umask: set and get 

close: close a 

dup: duplicate an open 

dup2: duplicate an open 


sact: print current SCCS 

crypt: password and 

endgrent, fgetgrent: get group 

get file system descriptor 
endpwent, fgetpwent: get password 
ulckpwdf: get shadow password 
utmpname, getutpid: access utmp 
putpwent: write password 
putspent: write shadow password 
fgrep: search a 

grep: search a 

egrep: search a 

proto: prototype job 

pathalias: alias 

ldaopen: open a common object 
acct: per-process accounting 

ar: common archive 

manager, updates text files in ISIS 
intro: introduction to 

sccstores: build RCS 

number entries of a common object 
filehdr: 

limits: 

unistd: 

ldfhread: read the 

Idohseek: seek to the optional 
split: split a 

mmap: map an open 
isismgr: ISIS 
merge: three-way 
ttyslot: find the slot in the utmp 
more: view a 


ISIS file format 
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file access and modification times... 
file access routines........ 
file and gets longest line. 
file and set mode, user, and group IDs.. 


file archiver. 
file archiver 
file archives in and out... ‘opto( 29) 
file attributes... -res(1) 


file checkers..... 
file comment section... 
file comparison... 


file control options... 
file COPY......csssessseee 
file creation mask. 
file descriptor... 
file descriptor. 
file descriptor... 
file: determine file type.. 
file editing activity...... 
file encryption functions 


etmntent(3SEQ) 


file for a character string... 
file for a pattern......ccveee a 
file for a pattern using full regular expressions... aren) 
file for at....... 
file for FACE 


file forMAat.....csscsesssssrsorsssesseseesesnssecseratanenereceseasonsenteneennens acct(4) 
file format ..see C and Lang Tools Binder 
file format. -isismgr(1M) 


file from SCCs file. 
file function... 
file header for common obje 
file header for implementation-specifi 
file header for symbolic constants... 
file header of a common object file. 
file header of a common object file. 
file into PieCeB........sccccseesssseereneers 
file into the processs address space. 
file manager, updates text files in.. 
file merge........ 
file of the current user. 
file one full screen at a time 
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fuser: identify processes using a 
creat: create a new 

pg: 

lseek: move read/write 

fseek, rewind, ftell: reposition a 
bfs: big 

from a two to a one password 

stat, Istat, fetat: get 

identify processes using a file or 
symbo] name for common object 
syms: common object 

newfs: construct a new 

/read directory entries and put in a 
/getmntent, hasmntopt, setmntent: get 
dirent: 

fs, inode: format of 

truncate, ftruncate: truncate a 
uusched: the scheduler for the uucp 
uucico: 

ftw: walk a 

file: determine 

umask: set 

object files 

mktemp: make a unique 

search Interpreter criteria for 
ctermid: generate 

ff: list 

ferror, feof, clearerr, 

search and print process accounting 
merge or add total accounting 
admin: create and administer SCCS 
cat: concatenate and print 

cmp: compare two 

or reject lines common to two sorted 
config: build system configuration 
cp, In, mv: copy, link or move 
.environ, .pref, .variables: FACE 

file header for common object 

find: find 

fspec: format specification in text 
fsplit: split 77, ratfor, or efi 

string, format of graphical 

ident: identify 

intro: introduction to special 

lockf: record locking on 

makedev: make system special 
peat, unpack: compress and expand 
pr: print 

and other information about RCS 
environment variables in core or in 
sort: sort and/or merge 

uucp: networking support 
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file or file structure. 
file or rewrite an existing one... 
file perusal filter for CRTs.. 
file pointer .........sssceee 
file pointer in a stream. 
file scanner... 
file scheme 
file status... 
file structure. 
file symbol table entry. 
file symbol table format 
file BYBLEM ....scsseseseseeeees 
file system independent format... 
file system descriptor file entry... 
file system independent directory entry... dirent(4) 
file system volume 
file to a specified length.. 
file transport program... 
file transport program for the uucp system. 
file tree 


file type... 

file-creation mode mask 

filehdr: file header for common. .-filehdr(4) 
filename. -mktemp(3C) 
filename.. pathconv(1F) 
filename for terminal. ..ctermid(3S) 


ee f(1M) 
.-ferror(3S) 


filenames and statistics for a filesystem... 
fileno: stream status inquiries.... 


Permuted Index 


what: identify SCCS 

link, unlink: link and unlink 
init.d: system level transition 

ISIS file manager, updates text 
passmgmt: password 

rm, rmdir: remove 

paste: merge same lines of several 


ott: files that hold object architecture i: 


checkfeys: check a 

list filenames and statistics for a 
mkfs: construct a 

mount: mount a 

repquota: summarize quotas for a 
tunefs: tune up an existing 
umount: unmount a 

volcopy: make literal copy of 
ckbupscd: check 
feck: 

dcheck: 

dump: incremental 
fstyp: determine 
dumpfs: dump 
statfs, fatatfs: get 
quotacheck: 
quotaon, quotaoff: turn 

restore: incremental 

ustat: get 

festat: report 

icheck: 

mnttab: mounted 

labelit: provide labels for 

mount, umount: mount and unmount 
umountall: mount, unmount multiple 
checklist: list of 

fstab: 

greek: select terminal 

nl: line numbering 

pg: file perusal 

col: 

Ipfilter: administer 


interactive repair 


for an object library lorder: 
display/change system boot 
/fpgetsticky, fpsetsticky: IEEE 
isnan: isnand, isnanf: test for 

ecvt, fevt, gevt: convert 

ldexp, modf: manipulate parts of 
ceiling, remainder, absolute value/ 
floor, ceil, fmod, fabs: 

fclose, flush: close or 

a co-process with the controlling 
floor, ceil, 
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files in ISIS file format... 
files management... 
files or directories... 
files or subsequent lines of one/.. 


filesystem... 
filesystem... 
filesystem... 
filesystem... 
filesystem.. 
filesystem.. 
filesystem.. 
filesystem . 
filesystem backup schedule. 
filesystem consistency check and. 
filesystem directory consistency check. 


filesystem dump....... dump(1M) 
filesystem identifier. ..fstyp(1M) 
filesystem information... ~-dumpfa(1M) 
filesystem information.....ssssssseresesesssseressssensessnears statfs(2) 
filesystem quota consistency checker quotacheck(1M) 
filesystem quotas on and off. .quotaon(1M) 
filesystem restore... estore(1M) 
filesystem statistics ustat(2) 
filesystem status. .fsstat(1M) 
filesystem storage consistency checl icheck(1M) 
filesystem table... mnttab(4) 
filesystems... Jabelit(1M) 


filesystems processed by fsck and ncheck 
file-system-table... 


filter for CRTs 
filter reverse line-feeds... 
filters used with the LP print service. 
find: find files 
see C and Lang Tools ‘Binder 
.. boot flags(1M) 
fpgetround(3C) 
«isnan(3C) 


floating-point environment control 
floating-point NaN (Not-A-Number).. 
floating-point number to string 
floating-point numbers...... 
floor, ceil, fmod, fabs: floor, 
floor, ceiling, remainder, absolute value/.. 
flush a stream... 
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stream 
tegetpgrp: get 
tcsetpgrp: set 


system diagnostic messages to 

reset: reset the current 

acct: per-process accounting file 
dump, dumpdates: incremental dump 
put in a file system independent 
updates text files in ISIS file 
common object file symbol table 
management functions format: 
other defect management functions 
mod_config: 

sys_config: 

newform: change the 

term: 


fs, inode: 
gps: graphical primitive string, 


resfile:. 


secafile: 

fspec: 

strfitime: 

intro: introduction to file 

utmp, wtmp: utmp and wtmp entry 
scanf, fecanf, sscanf: convert 

printf, fprintf, sprintf: print 
vprintf, vfprintf, vsprintf: print 
pwfix: remove incorrectly 
standalone embedded SCSI disk 
zdformat: standalone disk 
ASSIST menus or command 
ec: 

Ipforms: administer 
addformopt: add a 

ratfor: rational 

efi: Extended 

pathconf, 

fpgetround, fpsetround, 
fpsetmask, fpgetsticky,/ 
/fpsetround, fpgetmask, fpsetmask, 
printf, 

fpgetround, fpsetround, fpgetmask, 
fpgetsticky/ fpgetround, 
/fpgetmask, fpsetmask, fpgetsticky, 
pute, putchar, 

puts, 

getfrm: returns the current 


variables 
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: format of core image file.. 
io: format of cpio archive. 
;, format of curses screen i 
: format of directories 


fopen, freopen, fdopen: open a fopen(3S) 
foreground process group ID. tegetpgrp(2) 
foreground process group ID tesetpgrp(2) 
fork: create a new process.. ...fork(2) 
form error 1Og......sscscssssseees: dmesg(1M) 


form field to its default values 


format: format disks or perform.... 

format of a module configuration file 
format of a system configuration file.. 
format of a text file... 
format of compiled term file. 


mod_config(4) 


format of file system volume.. 
format of graphical files... 
format of RCS file 
format of SCCS file.. 
format specification in text files.. 
format time information... 
formats.. 
formats... 
formatted input... 
formatted output 
formatted output of a varargs/ 
formatted password entries.. 


.-fapec(4) 


vprintf{(3S) 
._pwfix(1M) 
.ccsformat(8) 


forms compiler 
forms used with the LP print service.. 
form/SELECT window option to a menu 
Fortran dialect........ 
Fortran Language... 
fpathconf: get configurable pathname.. 
fpgetmask, fpsetmask, fpgetsticky/.. 
fpgetround, fpsetround, fpgetmask 
fpgetsticky, fpsetsticky: IEEE/.. 
fprintf, sprintf: print formatted outpu 
fpsetmask, fpgetsticky, fpsetsticky/. 
fpsetround, fpgetmask, fpsetmask, 
fpsetsticky: IEEE floating-point/. 
fputc, putw: put character or wo 
fputs: put a string on a stream. 
frame DUMDET.........seesesseee sascaae 


Permuted Index 


t_free: 

df; report number of 

malloc, 

mallinfo: fast main memory/ malloc, 
fopen, 

of floating-point numbers 
gence: create a 

volume 

scanf, 

list of filesystems processed by 
and interactive repair 

file pointer in a stream 
generation numbers 

files 

files 


stat, lstat, 

statfs, 

identifier 

feeek, rewind, 

communication package stdipe: 
specified length truncate, 


function and complementary error 
gamma: log gamma 

hypot: Euclidean distance 

entries of a common object file 
matherr: error-handling 

prof: profile within a 

erf, erfc: error 

50, j1, jn, yO, yl, yn: Bessel 

crypt: password and file encryption 
logarithm, power, square root 
ceiling, remainder, absolute value 
or perform other defect management 
sinh, cosh, tanh: hyperbolic 
sysi86: machine specific 

keys to internal menu system 
acos, atan, atan2: trigonometric 
math: math 

intro: introduction to 

300, 300s: handle special 

hp: handle special 

450: handle special 

file or file structure 

specified controlling terminal 
fread, 

accounting records 

gamma: log 
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fread, fwrite: binary input/output . ...fread(3S) 


free a library structure......... _free(3N) 
free disk blocks and inodes.. ooo fC 1M) 
free, realloc, calloc: main memory allocato: -malloc(3C) 
free, realloc, calloc, mallopt..... -malloc(3X) 
freopen, fdopen: open a stream.... fopen(3S) 


frexp, ldexp, modf: manipulate parts. 
front-end to the cc command.. 
fs, inode: format of file system. 
fecanf, sscanf: convert formatted input. 
fack and ncheck.....s.ssesessesecssssssceeeees 
feck: filesystem consistency check . 
fseek, rewind, ftell: reposition a. 
feirand: install random inode..... 
fepec: format specification in text.. 
faplit: split 177, ratfor, or efl... 
festat: report filesystem status 
fatab: file-system-table. 
fetat: get file status....... 
fatatfs: get filesystem information. 
fatyp: determine filesystem.........+0+ 
ftell: reposition a file pointer in a stream 
ftok: standard interprocess. 
ftruncate: truncate a file to a.. 
ftw: walk a file tree... 


functions and constants 
functions and libraries...... 
functions of DASI 300 and 300s terminals 
functions of Hewlett-Packard terminals.. 
functions of the DASI 450 terminal. 
fuser: identify processes using a. 
fvhangup: virtually hangup the. 
fwrite: binary input/output... 
fwtmp, wtmpfix: manipulate connect. 
BamMMA FUNCtION.......cecereereerereer 
gamma: log gamma function... 


..gamma(3M) 
.gamma(3M) 
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ecvt, fevt, 

command 

command forms astgen: program for 
fsirand: install random inode 

rand, srand: simple random-number 
streamtty: 

tty: controlling terminal 
getgeombyname: get disk 

character or word from a stream 

or word from a stream getc, 
working directory 

put ina file system independent/ 
descriptor table index 

size 

getuid, geteuid, getgid, 

name 
getuid, 
number 
geometry by name 

getuid, geteuid, 

setgrent, endgrent, fgetgrent: get/ 
endgrent, fgetgrent: get/  getgrent, 
fgetgrent: get/ _getgrent, getgrgid, 
IDs 

currently marked menu items 


user, effective user, real/ 


file system/ addmntent, endmntent, 
stream 
argument vector 


getopts, 
options 


process group, and parent/__getpid, 
process, process group, and parent/ 
and parent process/ getpid, getpgrp, 
utilization information 


setpwent, endpwent, fgetpwent: get/ 
fgetpwent: get/ getpwent, getpwuid, 
endpwent, {getpwent: get/ getpwent, 
stream 

readfile, longline: reads file and 
scsiinfo structure 

getscsiinfo, 

endspent, fgetspent, Ickpwdf/ 
fgetspent, Ickpwdf/ getspent, 
speed and terminal settings used by 
speed, and line discipline 

ct: spawn 
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gevt: convert floating-point number to string.........ecvt(3C) 
gence: create a front-end to the cc .-gencc(1M) 
generating/modifying ASSIST menus or astgen(1) 
generation numbeFs........sese fsirand(1M) 
BENETALOL .....csssseesscresssesesenenees rand(3C) 
Generic STREAMS tty driver interfaci reamtty(7) 
(gentty) interface 


geometry by name... 
getc, getchar, fgetc, getw: ge’ 
getchar, fgetc, getw: get character. 
getcwd: get pathname of current... 


getgeombynam 


getdents: read directory entries and..........cssesee getdents(2) 
getdtablemax: get max in-use. getdtablemax(2SEQ) 
getdtablesize: get descriptor table......getdtablesize(2SEQ) 


getegid: get real user, effective user, real/ getuid(2) 
getenv: return value for environment getenv(3C) 
geteuid, getgid, getegid: get real...... wo. Betuid(2) 
getfrm: returns the current frame.. getfrm(1F) 


getgeombyname: get disk/.............. getgeombyname(3SEQ) 
getgid, getegid: get real user, effective user/........getuid(2) 
getgrent, getgrgid, getgrnam.... -getgrent(3C) 
getgrgid, getgrnam, setgrent.... -getgrent(3C) 
getgrnam, setgrent, endgrent, . -getgrent(3C) 
getgroups: get supplementary group. -getgroups(2) 
getitems: returns a list of the. ...getitems(1F) 
Getlogin: get login NAMC....csscssecssseserseseesessseer getlogin(3C) 
getmntent, hasmntopt, setmntent: get....getmntent(3SEQ) 
getmsg: get next message off a .getmsg(2) 
getopt: get option letter from .getopt(3C) 
getopt: parse command options... getopt(1) 
getoptcvt: parse command options.. ..getopts(1) 
getopts, getoptcvt: parse command af 

getpagesize: get system page size 
getpass: read a password....... 
getpgrp, getppid: get process, 
getpid, getpgrp, getppid: get.. 
getppid: get process, process group, os 
get_process_stats: get resource....get_process_stats(2SEQ) 
getpseudotty: get pseudo terminal......getpseudotty(3SEQ) 
getpw: get name from IUD getpw(3C) 
getpwent, getpwuid, getpwnam,.. getpwent(3C) 
getpwnam, setpwent, endpwent,. getpwent(3C) 
getpwuid, getpwnam, setpwent,.. 
gets, fgets: get a string from a. 
gets longest line.........s.cscssees 
getscsiinfo, getscsimatch: get 
getscsimatch: get scsiinfo structure 
getspent, getspnam, setspent.,... 
getspnam, setspent, endspent, 
getty... 
getty: set terminal type, modes... 
getty to a remote terminal 


..readfile(1F) 
.getscsiinfo(3SEQ) 
..getscsiinfo(3SEQ) - 
getspent(3X) 
getspent(3X) 
..gettydefs(4) 
..getty(1M) 
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settings used by getty 

get real user, effective user, real/ 
microsecond clock 

pututline, setutent, endutent,/ 
pututline, setutent,/ getut: 
getut: getutent, 

getut: getutent, getutid, 

/setutent, endutent, utmpname, 
getc, getchar, fgetc, 

zdinfo structure 

getzdinfo, 

m_next: increment 

task: 

operating system terms and symbols 
mktime, tzset/ ctime, localtime, 
setjmp, longjmp: non-local 

format of graphical files 

primitive string, format of 

of graphical files gps: 
plot: 

plot: 


chown, chgrp: change owner or 
newgrp: log in to a new 

run command in its own process 
initgroups: initialize 

setgroups: set 

/get real user, effective user, real 
/getppid: get process, process 
group: 

pwek, grpck: password/ 

setgrent, endgrent, fgetgrent: get 


setpgrp: set process 

create session and set process 
tegetpgrp: get foreground process 
tesetpgrp: set foreground process 
copy file and set mode, user, and 
getgroups: get supplementary 
user, real group, and effective 
setuid, setgid: set user and 

id: print user and 

groups: show 

chown: change owner and 

send a signal to a process or a 
maintain, update, and regenerate 


pwck, 
ssignal, 
stty, 


terminal fvhangup: virtually 
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gettydefs(4) 
+. getuid(2) 
getusclk(3SEQ) 


gettydefs: speed and terminal... 
getuid, geteuid, getgid, getegid: 
getusclk, usclk_init: get/init.... 


getut: getutent, getutid, getutline,. getut(3C) 
getutent, getutid, getutline,..........08 getut(3C) 
getutid, getutline, pututline, setutent/ getut(3C) 
getutline, pututline, setutent, endutent/ ..getut(3C) 
getutpid: access utmp file entry....eseeseeeees getut(3C) 
getw: get character or word from a stream ..gete(3S) 
getzdinfo, getzdinfobyname: get... getzdinfo(3SEQ) 
getzdinfobyname: get zdinfo structure......getzdinfo(3SEQ) 
global counter.......... ..Mm_next(3PPS) 
global security table «.task(4) 


glossary: definitions of common... .glossary(1) 


gmtime, asctime, cftime, ascftime, ctime(3C) 
LOCO sscsssssssscsosessnscesesscsessssacesvavsveoes setjmp(3C) 
gps: graphical primitive string, .-gps(4) 


graphical files. 
graphical primitive string, 
graphics interlace ......ssecsesesseeee 
graphics interface subroutines. 
greck: select terminal filter. 


“plot(4) 
..plot(3X) 
..greek(1) 


group... 
..newgrp(1M) 


group. 
group... .setpgrp(1) 
group access list initgroups(3SEQ) 
group access list... .setgroups(2SEQ) 
group, and effective group IDB..ssssssseseresnersereesees getuid(2) 


group, and parent process IDs. 


group file entry. tgrent(3C) 
QTOUP: QrOup file......csecsersecseeresaconcereseneesreeneenesnneeneenses group(4) 
group ID... setpgrp(2) 
QTOUP ID ...esccsssssessssessecsccecsssacsnssnsnesnssnssnsatencressneneenseases setsid(2) 
group ID ..tegetpgrp(2) 
group ID csetpgrp(2) 
QTOUP IDB...secsscsssssseensesenessesneseessenconsoronsssconsansneencencanennes cpset(1) 
group IDs. .getgroups(2) 
group IDs. getuid(2) 


group of a file........ 
group of processes. 
groups of programs.. 
groups: show group memberships... 
grpck: password/group file checkers.. 
gsignal: software signals........--s-csse 
gtty: set and get terminal state (defunct) 
hangup the specified controlling........+.++0+ 
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nohup: run a command immune to 
hsearch, hcreate, hdestroy: manage 
spell, hashmake, spellin, 

crypt, setkey, encrypt: generate 
spelling errors spell, 
addmntent, endmntent, getmntent, 
search tables hsearch, 
hsearch, hcreate, 

senhdr: section 

filehdr: file 

limits: file 

unistd: file 

ldfhread: read the file 

Idohseek: seek to the optional file 
/read an indexednamed section 
Idahread: read the archive 

helplog: monitor 

help: operating system 

helpadm: change the 


database 


file archiver hpio: 
hp: handle special functions of 
cronlog: cron 

ott: files that 

uptime: show 

Hewlett-Packard terminals 

tape file archiver 

hash search tables 

sinh, cosh, tanh: 


u3b5, vax: get processor/ machid: 
consistency check 


m_get_myid: return process 
issue: issue 
fstyp: determine filesystem 


shmget: get shared memory segment i 


file and set mode, user, and group 
getgroups: get supplementary group 
process group, and parent process 
real group, and effective group 
setuid, setgid: set user and group 
id: print user and group 

/fpsetmask, fpgetsticky, fpsetsticky: 


core: format ofcore i 
scr_dump: format of curses screen i 
crash: examine system i 


limits: file header for 
pwfix: remove 
m_next: 


DYNIX | ptx Reference Manual 


hangups and quits.. 

hash search tables... 

hashcheck: find spelling errors ..-8pell(1) 
hashing encryption ........00000 crypt(3 C) 
hashmake, spellin, hashcheck: find..........ssssssssesserseee spell(1) 
hasmntopt, setmntent: get file/... getmntent(3SEQ) 
hcreate, hdestroy: manage hash.. .-hsearch(3C) 
hdestroy: manage hash search tables.. ..hsearch(3C) 
header for a common object file... ... scnhdr(4) 
header for common object files... filehdr(4) 
header for implementation-specific constantzs........limits(4) 
header for symbolic constants... ....Unistd(4) 
header of a common object file .Adfhread(3X) 
header of a common object file .Idohseek(3X) 
header of a common object file..... -ldshread(3X) 
header of a member of an archive file... Idahread(3X) 
help actions.. .helplog(4) 
Help Facility 

Help Facility database. 


help: operating system Help Facility. 
helpadm: change the Help Facility 
helplog: monitor help actions.......... 
Hewlett-Packard 2645A terminal tape 
Hewlett-Packard terminals 
History file......ssssecsessseeses Te 
hold object architecture information 
how long system has been up..... 
hp: handle special functions of... 
hpio: Hewlett-Packard 2645A terminal .. 
hsearch, hcreate, hdestroy: manage.. 
hyperbolic functions....... sitnsaacseabeees 
hypot: Euclidean distance function... 
i386, ns32000, pdp11, u3b, u3b2 
icheck: filesystem storage 
ident: identify files. 
identification... 
identification file 
identifier... 


icheck(1M) 
-ident(1) 
-m_get_ esenan 


..getgroups(2) 


implementation-specific constants 


incorrectly formatted password entries... 
increment global counter... 


Permuted Index 


i 


dump, dumpdates: 

dump: 

restore: 

get maximum in-use descriptor table 
common/ ldtbindex: compute the 
common object/ ldtbread: read an 
commonldshread, Idnshread: read an 
ldsseek, Idnsseek: seek to an 

receipt of an orderly release 

receive a unit data error 


specific alarms and/or the working i 
specific alarms and/or the working/ i i 


calculate number of blocks and 
syscall: 

terminfo descriptions 

getusclk, usclk_init: get/ 


inittab: script forthe ini 


initialization 

files directory 

list 

init, telinit: process control 
reinit: run an 

bcheckre: system 

tput: 

s_init_barrier, s_wait_barrier: 
initgroups: 

/s_lock, s_clock, s_unlock: 
setup: 


clri: clear 

fs, 

fsirand: install random 

number of free disk blocks and 
facanf, sscanf: convert formatted 
ungete: push character back into 


fread, fwrite: binary. 


poll: STREAMS 

stdio: standard buffered 
uustat: uucp status 
install: 


feirand: 

onthe BOM _ bomverify: perform an 
on a disk 

product: 

installboot: 

with information from/ pweonv: 
dis386: disassemble Series 386 
mailx: 

filesystem consistency check and 
console: console 

Ip: Systech parallel line printer 
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incremental dump format.... dump(4) 


incremental filesystem dump.. .dump(1M) 
incremental filesystem restore... ..restore(1M) 

.getdtablemax(2SEQ) 
index of a symbol table entry of a.. ..ldtbindex(3X) 


.ldtbread(3X) 
.ldshread(3X) 


indexed symbol table entry of a. 
indexednamed section header of a 
indexednamed section of a common/. 
indication... 
indication... 


ob “revuderr(3N) 
indicator(1F) 
indicator(1F) 
-nblocks(3SEQ) 
saaneeal syscall(2) 
-infoemp(1M) 


indirect system call. 
infocmp: compare or print out.. 
init microsecond clock. 


init, telinit: process control.. 
init.d: system level transition. 
initgroups: initialize group access... 
initialization......... 
initialization file. 
initialization procedures... 


initialize a terminal or query terminfo database.....tput(1) 
initialize barrier, wait at barrier......s_wait_barrier(3PPS) 
initialize group access list.... initgroups(3SEQ) 


initialize, lock, unlock locks. s_lock(3PPS) 
initialize system for first user. 
inittab: script for the init proces 
IMOE ..sssecsssersesssrscceserecsssesrsecnenencoeee 
inode: format of file system volume... 
inode generation numbers....... 

inodes. 
input... 
input stream. 
input/output... 
input/output multiplexing 
input/output package..... 
inquiry and job control... 
install commands........ 
install: install commands. 
install random inode generation numbers... 
installation consistency check based.... 
installboot: installs a boot program.... 
installed products file. 
installs a boot program on a dis! 
installs and updates /etc/shadow 
IMStTUCtiONS......cecseresseeecceereroeeseneens 
interactive message processing system 
interactive repair 
interface 
interface 
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Sy 


mtio: UNIX magnetic tape 


plot: graphics i 
Generic STREAMS tty driver i 


swap: swap administrative 

termio: general terminal 

tg: SCSI 1/2-inch magnetic tape 

tty: controlling terminal (gentty) 

wp: SSM parallel line printer 

Xylogics 472 MULITBUS magnetic tape 
timod: Transport 

STREAMS module _tirdwr: Transport 
Transport Interface read/write 

plot: graphics 
sysadm: menu 
log: 

errorlog: 
syskeymap: identify keys to 

asa: 

pathconv: search 

csh: a shell (command 

pipe: create an 

ipes: report 

stdipe: ftok: standard 

tfipe: 

ncheck: generate pathnames from 
streamio: STREAMS 


and event tracing 


abort: generate an 

semaphore set, or shared memory ID 
communication facilities status 
/isxdigit, islower, isupper, isalpha, 
isdigit, isxdigit, islower, isupper, 
Ascntr], ispunct, isprint, isgraph, 
ttyname, 

/isupper, isalpha, isalnum, isspace, 
isalpha, isalnum, isspace, iscntrl/ 
Asspace, iscntrl, ispunct, isprint, 

file manager, updates text files in 
files in ISIS file format isismgr: 
text files in ISIS file format 

isdigit, isxdigit, 

floating-point NaN (Not-A-Number) 
isnan: 

(Not-A-Number) isnan: isnand, 
/isalnum, isspace, iscntrl, ispunct, 
Aisalpha, isalnum, isspace, iscntrl, 
Jislower, isupper, isalpha, isalnum, 


isdigit, isxdigit, islower, 
isalnum, isspace, iscntrl/ isdigit, 
getpw: get name from 


bessel:’ 
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...ratio(7) 
.»--plot(4) 
.streamtty(7) 


interface 
Interface cooperating STREAMS module.. 
Interface read/write interface... 
interface STREAMS module. 
interface subroutines... 
interface to do system administration. 
interface to STREAMS error logging. 
internal error log file.. 
internal menu system functions... 
interpret ASA carriage control characters... 
Interpreter criteria for filename........... 
interpreter) with C-like syntax.. 
interprocess channel....... eeawacaea 
inter-process communication facilities status 
interprocess communication package. 
interprocess communication reporter... 
i-numbers.......... 
ioct] commands.. 
ioct]: control device. 
TOT fault....sssseeee Cre 
iperm: remove a message queue, 
ipes: report inter-process...... 
isalnum, isspace, iscntrl, ispunct,/ 
isalpha, isalnum, isspace, iscntrl/ 
isascii, tolower, toupper, toascci, 
isatty: find name of a terminal... 
isentrl, ispunct, isprint, isgraph/.. 
isdigit, isxdigit, islower, isupper,.. 
isgraph, isascii, tolower, toupper/ 
ISIS file format....s.ssssssssscssceeesseees 
ISIS file manager, updates text... 
isismgr: ISIS file manager, updates.. 
islower, isupper, isalpha, isalnum, isspace,/. 
isnan: isnand, isnanf: test for. 
isnand, isnanf: test for floating-point NaN 
isnanf: test for floating-point NaN. 
isprint, isgraph, isascii, tolower/.. 
ispunct, isprint, isgraph, isascii/.. 
isspace, iscntrl, ispunct, isprint//. 
issue identification file ............008 
isupper, isalpha, isalnum, isspace,. 
isxdigit, islower, isupper, isalpha, 
TUD..eessssssssessesee cceasawsas sescesusocsalased 
jo, jl, jn, yO, y1, yn: Bessel functions 


..plot(3X) 
..sysadm(1) 


...8treamio(7) 
oo ioctl(2) 


-isnan(3C) 
-isnan(3C) 
-isnan(3C) 
»«ctype(3C) 
.ctype(3C) 


Permuted Index 


bessel: jO, 

bessel: jO, jl, 

uustat: uucp status inquiry and 
proto: prototype 


/erand48, lrand48, nrand48, mrand48, 
sigsetjmp, siglongjmp: non-local 
dumpconf: dump 

makekey: generate encryption 
syskeymap: identify 


apropos: locate commands by 

system command locate: use 
killall: 

m_kill_procs: 


a group of processes 


mem, 

kMBmem, 

ksh, rksh: 

standard/restricted command and/ 
integers and long integers 

and base-64 ASCII string a64], 
filesystems 

labelit: provide 

awk: pattern scanning and processing 
be: arbitrary-precision arithmetic 
efi: Extended Fortran 

command and programming 

pattern scanning and processing 
command programming 

cftime: 

chargefee, ckpacct, dodisk, 
/eetspent, endspent, fgetspent, 
/mrand48, jrand48, srand48, seed48, 
files 


ldclose, 

a member of an archive file 

for reading Idopen, 
object file 

floating-point numbers frexp, 
routines 
common object file 

common object file symbol table/ 
number entries of a common/Idlread, 
entries of a/ Idlread, Idlinit, 
manipulate line number entries of a/ 
number entries of a section of a/ 
entries of a section of a/ Idlseek, 
ofasectionofacommon/ ldrseek, 
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-bessel(3M) 
.bessel(3M) 
.uustat(1C) 


jl, jn, yO, yl, yn: Bessel functions.. 
jn, yO, yl, yn: Bessel functions. 
job control..... 
job file for at. 
join: relational database operator.. 
jrand48, srand48, seed48, lcong48//.. 


~_.drand48(3C) 


FUN PB isssapeecscscessncsssacscsss wecsesoessaasatsnes igsetjmp(3C) 
kernel auto-configuration device table. .dumpconf{1M) 
key....... asst yas sugadeugnasucsShonssassesudsueosdsaoabes ..makekey(1) 
keys to internal menu system functions.. yyskeymap(4) 
Keyword lookup ...scscsssssssesrereresserenee apropos(1) 


keywords to identify an operating. 
kill all active processes. 
kill child processes. 
kill: send a signal to a process or 
kill: terminate a process.......... 
killall: kill all active processes 
kMBmem, kMWmem: MULITBUS memory......... kmmem(7) 
kmem: core memory 
kMWmem: MULITBUS memory. 
KornShell, a standard/restricted command and /......ksh(1) 
ksh, rksh: KornShell, a.......00+ os 
13tol, ltol3: convert between 3-byte 
164a: convert between long integer 
labelit: provide labels for... 
labels for filesystems... 
language.......069 


-kill(2) 


...drand48(3C) 
ng Tools Binder 


lcong48: generate uniformly/. 
1d: link editor for object. 
1d0: STREAMS tty line discipline 
Idaclose: close a common object file. 
Idahread: read the archive header of 
ldaopen: open a common object file 
ldclose, ldaclose: close a common. 
ldexp, modf: manipulate parts of. 
ldfen: common object file acces: 
Idfhread: read the file header of a... 
ldgetname: retrieve symbol name for. 
Idlinit, Idlitem: manipulate line... 
Idlitem: manipulate line number. 


ldlseek, Idnlseek: seek to line 
ldnlseek: seek to line number... 
Idnrseek: seek to relocation entries. 
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section header of a/ ldshread, 
section of a common object/ ldsseek, 
header of a common object file 
object file for reading 

relocation entries of a section off 
indexednamed section header of a/ 
indexednamed section of a common/ 
symbol] table entry of a common/ 
table entry of a common object file 
of a common object file 

truncate a file to a specified 

init.d: system 

lexical tasks 

lex: generate programs for simple 
lsearch, 

intro: introduction to functions and 
find ordering relation for an object 
introduction to Parallel Programming 
t_syne: synchronize transport 
t_alloc: allocate a 

t_free: free a 

shell (command interpreter) with C- 
quota: display disk usage and 
ulimit: get and set user 
implementation-specific constants 
returns the number of CPUs on- 
line: read one 

puts its arguments on message 

all but one active processor off 

reads file and gets longest 

establish an out-going terminal 

set terminal type, modes, speed, and 
1d0: STREAMS tty 

set terminal type, modes, speed, and 
man: display on- 

linenum: 

Adlinit, ldlitem: manipulate 
acommon/ ldlseek, Idnlseek: seek to 
nl: 

cut: cut out selected fields of each 

Ip: Systech parallel 

wp: SSM parallel 


Isearch, lfind: 

col: filter reverse 

common object file 

readlink: read value of a symbolic 
link, unlink: 

Id: 

a.out: common assembler and 


cp, ln, mv: copy, 
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ldnshread: read an indexednamed.. 
ldnsseek: seek to an indexednamed 
Idohseek: seek to the optional file 
ldopen, Idaopen: open a common 
Idrseek, ldnrseek: seek to.........00 
ldshread, ldnshread: read an.... 
ldsseek, ldnsseek: seek to an..... 
Idtbindex: compute the index of a 
ldtbread: read an indexed symbol... 
ldtbseek: seek to the symbol table.. 
Nenigth sscisssesssasssscscsssssssscasevecreces y 
level transition files directory... 
lex: generate programs for simple... 


.-ldsseek(3X) 
«.Idtbindex(3X) 
Idtbread(3X) 
...1dtbseek(3X) 
..truncate(2SEQ) 
init.d(4) 


lexical tasks... -lex(1) 
lfind: linear sea: search(3C) 
libraries... intro(3) 
library.. .see C and Lang Tools Binder 
ADP APY svcsasccsvseasiiacssacasssaessabessesecsusens erat rereiscesscaes intro(3PPS) 
library... s-t_syne(3N) 


library structure... alloc(3N) 
library structure... t_free(3N) 
like syntax .¢8h(1) 
limits quota(1) 
limits... limit(2) 
limits: file header fo: seve limits(4) 
line... cpus_online(3PPS) 


line -line(1) 
line... essage(1F) 
line ffline_all(3SEQ) 


-readfile(1F) 
line connection.. 
line discipline... 


line discipline wwveld0(7) 
line discipline uugetty(1M) 
like man pa gen sicccscsscsiscscasescstesascscicenctacassctaccasssiesesassee man(1) 
line number entries in a common object file......linenum(4) 
line number entries of a common object/... -Idlread(3X) 
line number entries of a section of.. .ldlseek(3X) 


line numbering filter. 
line of a file. 
line printer interface... 
line printer interface 
line: read one line..... 
linear search and update 
line-feeds.. 


.-lsearch(3C) 
a..-CO1(1) 
inenum(4) 


-readlink(2SEQ) 
link and unlink files and CireCtOries ....esssccsseeeseeee .-link(1M) 
link editor for object files.......see C and Lang Tools Binder 
link editor output.. a.out(4) 
link: link to a file... i 


link or move files... 


Permuted Index 


——————————— aimee 


link: 
symlink: make symbolic 
and directories 


initgroups: initialize group access 
niist: get entries from name 
setgroups: set group access 
varargs: handle variable argument 
output of a varargs argument 

Is: 

ff: 

checklist: 
getitems: returns a 
t_listen: 

listing 

xargs: construct argument 
volcopy: make 

cp, 
ctime, 
apropos: 
operating system command 
setlocale: set programs 

end, etext, edata: last 
plock: 

m_lock, m_unlock: 

s_clock, s_unlock: initialize, 


feck and ncheck 


ascftime, mktime, tzset/ 


lockf; record 

m_lock, m_unlock: lock, unlock 
s_unlock: initialize, lock, unlock 
diagnostic messages to form error 
errorlog: internal error 

gamma: 

newgrp: 

logging and event tracing 

logarithm, power, square root/ exp, 
about RCS files rlog: print 
Ausr/adm/oginlog: 

sulog: 

logarithm, power, square/ exp, log, 
log, log10, pow, sqrt: exponential, 
strclean: STREAMS error 
strerr: STREAMS error 
log: interface to STREAMS error 
Ausr/adm/loginlog: log of failed 
getlogin: get 
logname: get 
cuserid: get character 

logname: return 

passwd: change 
tfmenush: assign menu system as user 
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see C and Lang Tools Binder 
initgroups(3SEQ) 
ere nlist(3C) 
.setgroups(2SEQ) 


list contents of directory 

list filenames and statistics for a filesystem. 

list of filesystems processed by ....ssseesere 

list of the currently marked menu items.........getitems(1F) 
listen for a connect request.....ssssssceseseesereen ..t_listen(3N) 


ee C and Lang Tools Binder 
xargs(1) 


list: produce C source... 
list(s) and execute comman 


literal copy of filesystem...... ..volcopy(1M) 
In, mv: copy, link or Move fI]C8.....ssseeecesateseenseseeeseeses cp(1) 
localtime, gmtime, asctime, cftime, ... ..ctime(3C) 
locate commands by keyword lookup. .apropos(1) 
locate: use keywords to identify an «elocate(1) 
LOCALION.....ssseseeeeeeeee i setlocale(3C) 
locations in program... ..end(3C) 
lock process, text, or data in memory. .plock(2) 
lock, unlock locks.... ock(3PPS) 
lock, unlock locks... s_lock(3PPS) 


lockf: record locking on files 
locking on files. 
locks..... 


.m_lock(3PPS) 
s_lock(3PPS) 


log gamma nctio’ 
log in to a new group... 
log: interface to STREAMS error.. 
log, log10, pow, sqrt: exponential, .. 
log messages and other information. 
log of failed login attempts... 
log of substitute user events. 
log10, pow, sqrt: exponential, .. 


logarithm, power, square root/ 

logger cleanup program. 3 relean( 1M) 
logger daemon.........-0+6 .strerr(1M) 
logging and event tracing......sesecssssessssnnsseeserensesereeseas log(7) 
login attempts... loginlog(4) 


-logname(3X) 
.-passwd(1) 
..tfmenush(1M) 
login(1) 


login name of user... 
login password and password a’ 
login shell....... 
login: sign on. 
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setting up an environment at 
Assr/adm/ 


setjmp, 

readfile, 

apropos: locate commands by keyword 
make a database for fast password 
relation for an object library 

the LP print service 

cancel: send/cancel requests to the 
lpadmin: configure the 

administer filters used with the 
administer forms used with the 
information about the status of the 
Apshut, lpmove: start/stop the 
enable, disable: enable/disable 
accept, reject: allow or prevent 
interface 

service 

with the LP print service 

the LP print service 

processing module 

service and move/ _Ipsched, Ipshut, 
the LP print service and move/ 

print service and move/ Ipsched, 
status of the LP print service 
supported by the menu system 
priorities 

srand48, seed48,/ drand48, erand48, 


update 


stat, 

integers and long integers 18tol, 
u3b2, u3b5, vax: get processor type/ 
show the configuration of the 

sysi86: 

values: 

sgetl: access long integer data in a 
m4: 

mtio: UNIX 

tg: SCSI 1/2-inch 

xt: Xylogics 472 MULITBUS 

mt: 

rmail: send mail to users or read 
read mail 

mail, rmail: send 

enhancement request 

processing system 

groups of programs make: 
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login time. 
loginlog: log of failed login attempts. 
logname: get login name 
logname: return login name of user. 
longjmp: non-local goto.........0 Cree 
longline: reads file and gets longest line .. 


sei apropos(1) 

....mkpwdbm(1M) 

see Lang Tools Binder 

lp, cancel: send/cancel requests to.. elp(1) 


LP print service... -lp(1) 
LP print service «lpadmin(1M) 
LP print service. Ipfilter(1M) 
LP print service. «.lpforms(1M) 
LP print SCTVi CO saisesscsssscssasecnesasccseasacssvoverevtasseasateassees Ipstat(1) 
LP print service and move request: ..lpsched(1M) 
LP printers... ..enable(1) 
LP requests... accept(1M) 
Ip: Systech parallel line printer........ssssssssssscsssseeseseseaes 1p(7) 
lpadmin: configure the LP print... -lpadmin(1M) 
Ipfilter: administer filters used.. Ipfilter(1M) 
Ipforms: administer forms used with .-lpforms(1M) 
Ipmod: parallel printer canonical. .-«lpmod(7) 


lpmove: start/stop the LP print.. 
Ipsched, lpshut, ]pmove: start/stop 
Ipshut, lpmove: start/stop the LP... 
Ipstat: print information about the... 
Iptypes: table of printer types. 
lpusers: set printing QUeUE.........s.c00se 
lrand48, nrand48, mrand48, jrand48 
1s: list contents of directory......... 
lsearch, lfind: linear search and. 
lseek: move read/write file pointer 
Istat, fetat: get file status... 
ltol3: convert between 3-byte... 
14: MACTO PLOCeSSOL ....cesesesees 
machid: i386, ns32000, pdp11, u3b 
MACHINE ......sssssseseonesseessesees 
machine specific functions 
machine-dependent values.. 
machine-independent fashion 
MACTO PYOCEBSOF....scseeeeee 
magnetic tape interface 
magnetic tape interface. 
magnetic tape interface... 
magnetic tape manipulating program. 
AMA ssicccicesusscasssesesssctemoiesanigersenearesstea 
mail, rmail: send mail to users or. 
mail to users or read mail... 
mailbug: submit a bug report or. 
mailx: interactive message.......... 
maintain, update, and regenerate. 
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programs intro: introduction to 
/ttyname_to_dev: convert between 
regenerate groups of programs 

man page databases 


databases makealiases, 
/free, realloc, calloc, mallopt, 
memory allocator 

mallopt, mallinfo: fast main memory/ 
malloc, free, realloc, calloc, 


makealiases, makewhatis: generate 
man: display on-line 

tsearch, tfind, tdelete, twalk: 
hsearch, hcreate, hdestroy: 
t_optmgmt: 

passmgmt: password files 
sigignore, sigpause: signal 
format disks or perform other defect 
file format isismgr-: ISIS file 
mt: magnetic tape 

parameters of virtual-to-physical 
m_single, m_multi: 

umask: set file-creation mode 
umask: set and get file creation 
regex: 

regular expression compile and 
math: 


endpoint 


comment section 


read the archive header of a 

groups: show group 

memset: memory operationsmemory: 
memory operationnemory: memccpy, 
operatiomemory: memccpy, memchr, 
memory: memcepy, memchr, memcmp, 
kMBmem, kMWmem: MULITBUS 
mem, kmem: core 

lock process, text, or data in 

create security table in shared 
malloc, free, realloc, calloc: main 
calloc, mallopt, mallinfo: fast main 
shmalloc, shrealloc, shfree: shared 
valloc: aligned 

shmct]: shared 

consmem, sm, 8s: console 

dump: standalone 

spawn new process in a virtual 
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maintenance commands and application........ss.000 intro(1) 
major/minor numbers/tty names.. dev_to_ttyname(3C) 
make: maintain, update, and......ccssssssssecsesesssersensees make(1) 
makealiases, makewhatis: generate makealiases(1M) 
makedev: make system special files .-makedev(1M) 
makekey: generate encryption key.. ....makekey(1) 
makewhatis: generate man page. makealiases(1M) 


mallinfo: fast main memory allocator. 
malloc, free, realloc, calloc: main. 
malloc, free, realloc, calloc, 
mallopt, mallinfo: fast main memory/ 
man: display on-line man pages 
man page databases.. 


makealiases(1M) 


man pages. .eman(1) 
manage binary search trees .tsearch(3C) 
manage hash search tables... hsearch(3C) 
manage options for a transport. __optmgmt(3N) 
management... passmgmt(1M) 
MANA PeMeN Css. sssstescsstrisseneeeanecrnta ARI sigset(2) 
management functions. .format(1M) 
manager, updates text files in ISIS. ismgr(1M) 


manipulating Program .essresssessecsssneeseseeneseseneeseneeesones mt(1) 
mapping devices ......+.+« pmap(1M) 
mark single-process code section. .m_single(3PPS) 
mask... -umask(1) 
mask... -umask(2) 
match patterns against a string. .regex(1F) 
match routines... -regexp(5) 
math functions and constants math(5) 
math: math functions and constants ./math(5) 
matherr: error-handling function... .-matherr(3M) 
mbad: MULITBUS adapter....... mbad(7) 
mes: manipulate the object file.. mes(1) 
mem, kmem: core memory... mem(7) 
member of an archive file Idahread(3X) 
MEMbETSHIPS .....ssssersecseserseeecersecereerencarsnsneoenceranenesees groups(1) 
memcecpy, memchr, memcmp, memepy,. memory(3C) 
memchr, memcmp, memcpy, memset: memory(3C) 
memcmp, memepy, memset: memory... memory(3C) 
memepy, memset: memory operations memory(3C) 
memory. .-.kmmem(7) 
memory.. mem(7) 
memory... plock(2) 
memory. tasktbl(1M) 
memory allocator. .malloc(3C) 
memory allocator. .-malloc(3X) 
memory allocator .shmalloc(3PPS) 
memory allocator... -valloc(3SEQ) 
memory control operations.. ..- Shmctl(2) 

consmem(7) 


memory drivers... 
memory dump... 
memory efficient way 
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© queue, semaphore set, or shared 


memcpy, memset: memory operations 
memchr, memcemp, memepy, memset: 
shmop, shmat, shmdt: shared 

vimtune: tune system-wide virtual- 
shmget: get shared 

vm_ctl: examine and change virtual 
memccpy, memchr, mememp, memcpy, 
addcmdopt: add a command option to a 
add a form/SELECT window option to a 
addmenuopt: add a menu option to a 
sysadm: 

a list of the currently marked 


menumsg: route user message to 
rmvopt: remove a 

addmenuopt: add a 

menu: 

of printer types supported by the 
tfmenush: assign 

syskeymap: identify keys to internal 
message queue 

for generating/modifying ASSIST 
merge: three-way file 


sort: sort and/or 
& acctmerg: 
resmerge: 


subsequent lines of one file _ paste: 


t_error: produce error 

tfnotify: send completion 

msgctl: 

message: puts its arguments on 
getmsg: get next 

putmsg: send a 

msgop: 

mailx: interactive 

message line 

menumsg: route user message to menu 
msgget: get 

shared memory ID ipcrm: remove a 
errormsg: error 

menumsg: route user 

motd: 

mesg: permit or deny 

sys_errlist, sys_nerr: system error 
strace: print STREAMS trace 

rlog: print log 

dmesg: collect system diagnostic 


parallel 
J identification 
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memory: memccpy, memchr, memcmp, .. 
memory operations... 
memory operations. 
memory parameters.. 
memory segment identifier..... 
memory tuning parameters 
memset: memory operations... 


menu... ‘addemdopt( 1M) 
menu addformopt(1M) 
menu... ..addmenuopt(1M) 


menu interface to do system administration.......aysadm(1) 
menu items... etitema(1F) 
menu: menu processor.. aad 
menu message queue menumsg({1M) 
menu option... ...rmvopt(1M) 
menu option to a menu.. seni oi 
menu processor 
menu system..... 
menu system as user login shell.. 
menu system functiona......... ae 
menumsg: route user message to menu........menumsg(1M) 
menus or command forms -astgen(1) 


METZ! «0.004 -merge(1) 
merge files... soe 80Tt(1) 
merge or add total accounting files... acctmerg(1M) 


Merge RCS revisionSs ........ssssseeeesseee 
merge same lines of several files o} 
merge: three-way file merge....... 


mesg: permit or-deny messages.. .. mesg(1) 
message... t_error(3N) 
message... tfnotify(1M) 
message contro] operations.. msgctl(2) 


message line... .message(1F) 
message off a stream.. 
message on a stream... 
message operations..... 
message processing system... 
message: puts its arguments on.. 
MESSAGE QUEUEC........0-0. 


“message( 1F) 
.-menumsg(1M) 


MESSAGE QUEUE.........0004 magget(2) 
message queue, semaphore set, or. iperm(1) 
message text file. 

message to menu message queue... 

message-of-the-day file. 


messages. 
messages. 


.strace(1M) 
messages and other information about RCS files.......rlog(1) 
messages to form error log......sscscsscsssessssesseseceesee dmesg(1M) 
m_fork: execute a subprogram in....... m_fork(3PPS) 
m_get_myid: return process............ m_get_myid(3PPS) 
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number of child processes 

getusclk, usclk_init: get/init 

usclk: 32-bit 

aging, PFF, swapping, or processor 
clone: open any 

/convert between major/ 

/acctwtmp: overview of accounting and 
intro: introduction to 


special or ordinary file 
password lookup 


/gmtime, asctime, cftime, ascftime, 


processs address space 


section m_single, 


configuration file 

chmod: change 

umask: set file-creation 

chmod: change 

cpset: copy file and set 

getty: set terminal type, 
uugetty: set terminal type, 
frexp, ldexp, 

utime: set file access and 
touch: update access and 
astgen: program for generating/ 
printer canonical processing 
SSM: System Services 

Interface cooperating STREAMS 
read/write interface STREAMS 
mod_config: format of a 
/ckpacct, dodisk, lastlogin, 
helplog: 


monitor: 
atime 


mount: 
mount, umount: 


setmnt: establish 
filesystems 
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m_get_numprocs: return.. ...I_get_numprocs(3PPS) 


microsecond clock....... getusclk(3SEQ) 
MIcTOSECON COUNEET...-.essssererseseseresesneesersesesersoencanensors usclk(7) 
migration disabled..... -noage(1M) 
minor device on a STREAMS driver clone(7) 
minor numbers and tty names.........+ dev_to_ttyname(3C) 
miscellaneous accounting commands... -acct( 1M) 
Miscellany.....ccsscsseeeeee 

mkdir: make a directory. 

mkdir: make directories... 

mkfifo: make a FIFO special file... 

mkfs: construct a filesystem... 

m_kill_procs: kill child processes... m, "kill_procs(3PPS) 
mknod: build special file.. .«mknod(1M) 


mknod: make a directory, or 


mktemp: make a unique filename... 
mktime, tzset: convert date and time/. 
mkvtoc: populate VTOC on disks....... 
m_lock, m_unlock: lock, unlock locks... 
mmap: map an open file into the... 
m_multi: mark single-process cod 
m_next: increment global counter 
munttab: mounted filesystem table 
mod_config: format of a module. 
MOAE.....0ss000ee 
mode mask...» 

mode of file...... 

mode, user, and group IDs. 
modes, speed, and line disciplin 
modes, speed, and line discipline... 
modf: manipulate parts of floating-point/. 
modification times........ acoaed 
modification times of a file... 
modifying ASSIST menus or command/ 


module.. Ipmod(7) 
Module.. .ssm(7) 
module .. imod(7) 
module. tirdwr(7) 
module configuration file. mod_config(4) 
monacct, nulladm, pretmp, prdaily, acctsh(1M) 


monitor help actionSs......sscesse 
monitor: monitor system activity .. 
monitor: prepare execution profile 
Monitor system ACtIVILY....ccsereerenee 
more: view a file one full screen at... 
motd: message-of-the-day file 
mount a filesystem .......sseere 
mount and unmount filesystems.. 
mount: mount a filesystem. 
mount table........scccsserereesseen 
mount, umount: mount and unmount.. 


monitor 1M) 
monitor(3C) 
.-monitor( 1M) 


-mount(2) 
«mount(1M) 
-mount(2) 
setmnt(1M) 
-mount(1M) 
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mountall, umountall: 

multiple filesystems 

mnttab: 

mvdir: 

cp, In, mv: copy, link or 

lseek: 

start/stop the LP print service and 
and resume child process execution 


ptrace, 

drand48, erand48, lrand48, nrand48, 
child process/ m_park_procs, 
processes 


single-process code section 


program 
st: Systech 


mbad: 
xt: Xylogics 472 
kMBmem, kMWmem: 
mountall, umountall: mount, unmount 
poll: STREAMS input/output 
Systech MTI-800/1600/1650 terminal 
xs: Xylogics 781 terminal 
tmp_ctl: 
rc2: run commands performed for 
m_lock, 
address space 


cp, In, 


devnm: device 

getenv: return value for environment 
getgeombyname: get disk geometry by 
getlogin: get login 

logname: get login 

pwd: working directory 
tmpnam, tempnam: create a 
ldgetname: retrieve symbol 
getpw: get 

nlist: get entries from 
rename: change the 
ttyname, isatty: find 

uname: get 

uname: print 

tty: get the 

cuserid: get character login 
logname: return login 
Adnshread: read an indexed 
Adnsseek: seek to an indexed 


table/ 
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mount, unmount multiple filesystems. 


mountall, umountall: mount, unmount. mountall(1M) 
mounted filesystem table. .mnttab(4) 
move a directory... -mvdir{ 1M) 
move files........00 ++ CP(1) 
move read/write file pointer seek(2) 


move requests.. 
m_park_procs, m_rele_procs: sus 
mptrace: process trace facility 
mrand48, jrand48, srand48, seed48,/ 
m_rele_procs: suspend and resume... 

m_set_procs: set number of child... 
uosgctl: message control operations.... 
msgget: get message queue.. 
msgop: message operations. 
m_single, m_multi: mark.. 
m_syne: check in at barrier.. 
mt: magnetic tape manipulating. 
MTI-800/1600/1650 terminal multiplexor driver.. 
mtio: UNIX magnetic tape interface . 
MULITBUS adaptel.....ssssssscerseseses 
MULITBUS magnetic “are interface .. 
MULITBUS memory.. 
multiple filesystems. “ 
multiplexing........ 
moultiplexor driver.. 
multiplexor driver... 


.-lpsched(1M) 
-to_park_procs(3PPS) 
ptrace(2) 
.drand48(3C) 


.m_park_procs(3PPS) 
-m_set, ee 


+0eeX8(7) 


multi-processor control. .tmp_ctl(2SEQ) 
MUIti-user ENVITONMENL.....csescsesesecseessaeecserensecsneeeneees re2(1M) 
m_unlock: lock, unlock locks m_lock(3PPS) 


munmap: unmap part of the processs.. 
mv: copy, link or move files........ 
mvdir: move a directory... 
name.. 
name... 
name... 
nami 
nami 
name... 

name for a temporary file 
name for common object file symbol.. 
name from IUD 
name list....... 


-rename(2) 
name of a terminal. 
name of current operating system. 
name of current system.. 
name of the terminal.. 
name of the user.. 
name of user. 
named section header of a common object/. 
named section of a common object file .......sss0 ldsseek(3X) 
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between major/minor numbers and tty 
id: print user and group IDs and 

term: conventional 

isnanf: test for floating-point 
processing language 

and indirect blocks 

of filesystems processed by feck and 
i-numbers 

uucp: 

file 


news: print 


getmsg: get 


object file 

command with priority aging, PFF/ 
hangups and quits 

setjmp, longjmp: 

sigsetjmp, siglongjmp: 

with priority aging, PFF/ noage, 
priority aging, PFF/ —_ noage, nopff, 
test for floating-point NaN 

seed48/ drand48, erand48, lrand48, 
deroff: remove 

vax: get processor/ machid: i386, 
null: the 
/ckpacct, dodisk, lastlogin, monacct, 
obtain the prime factors of a 

getfrm: returns the current frame 
test for floating-point NaN (Not-A- 
convert string to double-precision 
linenum: line 

Adlinit, ldlitem: manipulate line 
ldlseek, Ildnlseek: seek to line 

rand, srand: simple random- 
nblocks: calculate 

m_get_numprocs: return 
m_set_procs: set 

cpus_online: returns the 

df: report 

fevt, gevt: convert floating-point 

nl: line 

uniformly distributed pseudorandom 
manipulate parts of floating-point 
install random inode generation 
to system calls and error 
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dev_to_ttyname(3C) 
.-id(1M) 


names... 


names for terminals.. term(5) 
NaN (Not-A-Number)... isnan(3C) 
nawk: pattern scanning and .....escssessesesneescreessenees nawk(1) 
nblocks: calculate number of blocks ..nblocks(3SEQ) 


ncheck 
ncheck: generate pat 
networking support file8...........00 
newform: change the format of a text. 
newfs: construct a new file system... 
newgrp: log in to a new group 


DEWS ItOMB.....sccseceereeeeees news(1) 
news: print news items. news(1) 
next message off a stream getmsg(2) 


.nice(2) 
snice(1) 


nice: change priority of a process.. 
nice: run a command at low priority 


nl: line numbering filter....cssssssesssssserssssseesserersessracssrers nl(1) 
niist: get entries from name list -nlist(3C) 
nm: print name list of............8ee C and Lang Tools Binder 
noage, nopff, noswap, onproc: run a.. .-noage(1M) 
nohup: run a command immune to -nohup(1) 
non-local goto...... .setjmp(3C) 
non-local jumps... sigsetjmp(3C) 
nopff, noswap, onproc: run a comman noage(1M) 
noswap, onproc: run a command with. oage(1M) 
(Not-A-Numbe?).....ssesessseesseserereneneeeees isnan(3C) 
nrand48, mrand48, jrand48, ‘srand48 ..drand48(3C) 
nroff, tbl, and eqn constructs... «.deroff{1) 
ns32000, pdp11, u3b, u3b2, u3b5,. machid(1) 
null file......s.sc0000 -oull(7) 
null: the null file .null(7) 
nulladm, pretmp, prdaily, prtacct//.. .acctsh(1M) 
number.. ..factor(1) 
number. .getirm(1F) 
Number) isnan(3C) 
number... ..8trtod(3C) 
number entries in a common objec! ‘Hnenum(4) 
number entries of a common object/.. ldlread(3X) 
number entries of a section of a/ Idlseek(3X) 
number generator... ...rand(3C) 
number of blocks and indirect blocks........... nblocks(3SEQ) 


m_get_numprocs(3PPS) 
.m_set_procs(8PPS) 
..cpus_online(3PPS) 
-df(1M) 
wecvt(3C) 


number of child processes .... 
number of child processes. 
number of CPUs on-line... 
number of free disk blocks and inodes. 
number to string.... 


mumbering filter....ssssssessssecseesnesesseeceseussennonsaseennervecescessees nl(1) 
numbers... .-drand48(3C) 
numbers ...frexp(3C) 
numbers 'sirand(1M) 
intro(2) 
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ncheck: generate pathnames from i- 
‘convert between major/minor 

cprs: compress an 

strstr: find first 

od: 


offline: bring processors online and 
online, 

processor off line 

online, offline: bring processors 
online and offline 
noage, nopff, noswap, 
Idopen, Idaopen: 
fopen, freopen, fdopen: 
clone: 

dup: duplicate an 
dup2: duplicate an 
mmap: map an 

open: 


aging, PFF/ 


rewinddir, closedir:/ directory: 

a standalone program or bring up the 
run commands performed to stop the 
savecore: save a core dump of the 
uname: get name of current 

locate: use keywords to identify an 
assist: assistance using 

starter: information about the 

help: 

glossary: definitions of common 

join: relational database 

curses: terminal screen handling and 
rmvopt: remove a menu 

getopt: get 

addcmdopt: add a command 
addformopt: add a form/SELECT window 
addmenuopt: add a menu 
ldohseek: seek to the 
fentl: file control 

getopt: parse command 
getopts, getoptcvt: parse command 
stty: set the 

t_optmgmt: manage 

make a directory, or a special or 
architecture information 

common assembler and link editor 
echo: put string on virtual 

fread, fwrite: binary input/ 

fprintf, sprintf: print formatted 
poll: STREAMS input/ 

/vfprintf, vsprintf: print formatted 
stdio: standard buffered input/ 


object file 
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...ncheck(1M) 
lev_to_ttyname(3C) 


Octal MUMP....sssesssessrsenees 
od: octal dump. 
OfFIME «0... esecees 
offline: bring processors online and offline... 
offline_all: take all but one active... 
online and offline... 
online, offline: bring processo 
onproc: run a command with priority 
open a common object file for reading... 
open a stream.. 
open any minor device on a 
open file descriptor..... 
open file descriptor... 
open file into the processs address space... 
open for reading or writing......... 
open: open for reading or writing.. 
opendir, readdir, telldir, seekdir, 


operating system..... ...boot(8) 
operating system.. rc0(1M) 
operating system savecore(1M) 
operating system.... uname(2) 


operating system command. 
operating system commands... 
operating system for beginning users... 
operating system Help Facility.......... 
operating system terms and symbols. 


..rmvopt(1M) 


option letter from argument vector. .. getopt(3C) 
option to a menu. addcmdopt(1M) 
option to a menu. .addformopt(1M) 
option to a menu. addmenuopt(1M) 
optional file header of a common Idohseek(3X) 
options... .fentl(5) 
options getopt(1) 
options... getopts(1) 
options for a terminal ...8tty(1) 
options for a transport endpoint t_optmgmt(3N) 


ordinary file...... 


output multiplexing 
output of a varargs argument list. 
output package 


Permuted Index 


ee 


setpgrp: run command in its 
chown: change 

chown, chgrp: change 

expand files 

makewhatis: generate man 
getpagesize: get system 

4014: 

m_fork: execute a subprogram in 
Ip: Systech 

wp: SSM 

Ipmod: 

intro: introduction to 

and change virtua] memory tuning 
tune system-wide virtual-memory 
pmap: display or alter 

get process, process group, and 
getopt: 

getopts, getoptcvt: 

cmpt: compatibility 

, vtoc: VTOC 
frexp, ldexp, modf: manipulate 


with information from /etc/ 
password attributes 


getpass: read a 

crypt: 

passwd: change login 

passwd: change login password and 
pwdhd: daemon to oversee 

pwfix: remove incorrectly formatted 
passwd: 

shadow: restricted 

setpwent, endpwent, fgetpwent: get 
Ickpwdf, ulckpwdf: get shadow 
putpwent: write 

putspent: write shadow 

converts from a two to a one 
passmgmt: 

mkpwdbm: make a database for fast 
pwek, grpck: 

files or subsequent lines of one/ 

bp: binary 


configurable pathname variables 
criteria for filename 

getewd: get 

fpathconf: get configurable 
dirname: deliver portions of 
ncheck: generate 

sweepon, sweepoff: enable/disable 
grep: search a file for a 
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OWN process ZTOuUP.......0.0+6. 
owner and group of a file. 
owner or group... 
pack, peat, unpack: compress an 


page databases. makealiases( 1M) 
page size getpagesize(2SEQ) 
paginator for the Tektronix 4014 terminal... 4014(1) 
parallel 

parallel line printer interface 


parallel line printer interface 
parallel printer canonical processing module.. 
Parallel Programming Library 
parameters... 
parameters... 
parameters of virtual-to-physical mapping/. 
parent process IDBa...... 
parse command options. 
parse command options 
partitioning driver. 
partitioning driver. 
parts of floating-point numbers.... 

passmgmt: password files management. 
PABBW....sersesseseers cacsosocentestase sesesseus 
passwd: change login password and. 
passwd: password file 
PASBWOTT woreseesssees ore 
password and file encryption functions... 
password and password attributes... 


password attributes..........04. passwd(1) 
password database creation pwdhd(1M) 
PASSWOTT ENETICB ....c.cssesessecees 


password file.. 
password file... 
password file entry... 
password file entry. 
password file entry. 
password file entry.. 
password file scheme.. 
password files management 


password lookup... 

password/group file checkers... 

paste: merge same lines of several paste(1) 
POH OF cccsccnssconinammnns bp(1M) 
pathalias: alias file for FACE alias(4) 
pathconf, fpathconf: get. 


-pathconv(1F) 
.getcwd(3C) 
pathconf(2) 


pathconv: search Interpreter........-s:ssseseee 
pathname of current working directory .. 
pathname variables. 


pathnames... -basename(1) 
pathnames from i-numbers... ncheck(1M) 
patrol seeks on DCC disks. 


PALLET ...ecsscreeerseee: 
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awk: 

nawk: 

egrep: search a file for a 
regex: match 


pack, 
popen, 


machid: i386, ns32000, 

sigpending: examine 

check the uucp directories and 
acct: 

acctcms: command summary from 
sys_nerr: system error messages 
run a command with priority aging, 


virtual address space pmap: map 
or alter parameters of virtual-to- 


sp: STREAMS | 


tee: 
popen, pclose: initiate 
in memory 


virtual-to-physical mapping devices 
processs virtual address space 
/fpsetsticky: IEEE floating- 

isnand, isnanf: test for floating- 
ecvt, fevt, gcvt: convert floating- 
modf: manipulate parts of floating- 
lseek: move read/write file 

rewind, ftell: reposition a file 
multiplexing 

a process 

banner: make 

power, square root/ exp, log, log10, 
pow, sqrt: exponential, logarithm, 


/dodisk, lastlogin, monacct, nulladm, 
Aastlogin, monacct, nulladm, pretmp, 
be: arbitrary- 

atof: convert string to double- 
environ, 

monitor: 

cpp: the C language 

factor: obtain the 

gps: graphical 

types: 

prs: 

date: 

cal: 
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pattern scanning and processing language 
pattern scanning and processing language.. 
pattern using full regular/. 
patterns against a string... 
pause: suspend process until signal 
peat, unpack: compress and expand files. 


pclose: initiate pipe to/from a process... ~popen(3S) 
pdbx, dbx: parallel/....ssscseses see C and Lang Tools Binder 
pdp11, u3b, u3b2, u3b5, vax: get processor/.........machid(1) 
pending signals. 


permissions file.. 
per-process accounting file format... 
per-process accounting records 
perror, errno, sys_errlist, 
PFF, swapping, or processor/ 
pg: file perusal filter for CRTs... 
physical addresses into processs.. 
physical mapping devices........... 
pipe: create an interprocess channel... 
pipe device... 
pipe fitting... 
pipe to/from a process.. 
plock: lock process, text, or data.. 
plot: graphics interface.......... 
plot: graphics interface subroutines 
pmap: display or alter parameters of. 


ene 


pmap: map physical addresses into svrsssoreves PAPC 7) 
point environment control... fpgetround(3C) 
point NaN (Not-A-Number, ..isnan(3C) 
point number to string ecvt(3C) 
point numbers frexp(3C) 
POINEL........s00e Iseek(2) 


pointer in a stream... 
poll: STREAMS input/output... 
popen, pclose: initiate pipe to/from 
POBLETS «...cercorersersccerecescoreccacanesoereses: 
pow, sqrt: exponential, logarithm, 
power, square root functions. 


..banner(1) 
.exp(3M) 
-exp(3M) 


PsPrint fleas isscsiscsssisassiassscceanessrsccaststtastasiesseseasicencareasesis pr(1) 
pretmp, prdaily, prtacct, shutacct,/ acctsh(1M) 
prdaily, prtacct, shutacct, startup, acctsh(1M) 
precision arithmetic language.....cssssssrsseseeenseseencescene be(1) 
precision number........ eer .strtod(3C) 
-pref, .variables: FACE files -env(4) 
prepare execution profile -monitor(3C) 
preprocessor see C and Lang Tools Binder 
prime factors of a number. .factor(1) 
primitive string, format of graphical files. ..gps(4) 


primitive system data types.. 
print an SCCS file...... 
print and set the date.. 
print calendar 
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sum: 

sact: 

cat: concatenate and 

pr: 

printf, fprintf, sprintf: 

vprintf, vfprintf, vsprintf: 

of the LP print service Ipstat: 
information about RCS files rlog: 
object file mm: 
uname: 

news: 


infocmp: compare or 

acctcom: search and 

of object files size: 
send/cancel requests to the LP 
Ipadmin: configure the LP 
administer filters used with the LP 
administer forms used with the LP 
about the status of the LP 

Apshut, lpmove: start/stop the LP 
strace: 

prtvtoc: 

prtvtoc: 

id: 

Ipmod: parallel 

Ip: Systech parallel line 

wp: SSM parallel line 

Iptypes: table of 

enable, disable: enable/disable LP 
formatted output 

lpusers: set 

Ipusers: set printing queue 

nice: run a command at low 
/noswap, onproc: run a command with 
nice: change 

brk, sbrk; change 

process attributes 

codestroy: communicate to a 

exit, _exit: terminate 

fork: create a new 

inittab: script for the init 

kill: terminate a 

nice: change priority of a 

pelose: initiate pipe to/from a 
wait: await completion of 

acct: enable or disable 

acctprel, acctpre2: 

acct: per- 

acctcom: search and print 
acctems: command summary from per- 
alarm: set a 

times: get 
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print checksum and block count of a file... .sum(1) 
print current SCCS file editing activity sact(1) 
PYint files.......esessecees cat(1) 
print files... sss «pr(1) 
print formatted output. print{(3S) 
print formatted output of a varargs/.. -vprint (3S) 
print information about the status «lpstat(1) 
print log messages and other. 

print name list of... 

print name of current SySteM......cssssessseeesensenesiesee uname(1) 
print news items news(1) 
print out terminfo descriptions -infoemp(1M) 
print process accounting files.. acctcom(1) 
print section sizes.. .see C and Lang Tools Binder 
PINE SOLVICE sissssssesassascsssscsnsccpscsescsasinsessarsssasuaviasssieessisasecde 1p(1) 
print service. Ipadmin(1M) 
print service... Ipfilter(1M) 
print service ..lpforms(1M) 
print service... ssnasbafabesti vadsscsttnias eseasssaszseese Ipstat(1) 
print service and move requests.. .. lpsched(1M) 
print STREAMS trace messages .strace(1M) 
print the VTOC of a block device... prtvtoc(1M) 
print the VTOC of a standalone disk device. 


print user and group IDs and names. 
printer canonical processing module. 
printer interface... 
printer interface... 
printer types supported by the menu system.. 


“Iptypes(4) 
enable(1) 
.-print{(3S) 
.. pusers(1M) 
.. |pusers(1M) 
..nice(1) 


printf, fprintf, sprintf: print... 
printing queue priorities.. 


private data segment size... 
proc_ctl: control over various. proc_ctl(2SEQ) 
-coproc( 1F) 
exit(2) 
fork(2) 
.inittab(4) 
-kill(1) 
nice(2) 
-popen(3S) 
. Wait(1) 
acct(2) 
.acctpre(1M) 


process accounting... 
...acct(4) 


process accounting file forma‘ 


process accounting files.......... acctcom(1) 
process accounting records. acctems(1M) 
process alarm clock.......... .-alarm(2) 


process and child process times. ...-times(2) 
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proc_ctl: control over various 
m_single, m_multi: mark single- 
ipes: report inter- 

init, telinit: 

timex: time a command; report 
suspend and resume child 
setpgrp: run command in its own 
/getpgrp, getppid: get process, 
setpgrp: set 

setsid: create session and set 
tegetpgrp: get foreground 
tesetpgrp: set foreground 
m_get_myid: return 

process, process group, and parent 
vfork: spawn new 

kill: send a signal toa 

getpid, getpgrp, getppid: get 

ps: report 

plock: lock 

times: get process and child 
tmp_affinity: bind a 

wait, waitpid: wait for a child 
ptrace, mptrace: 
pause: suspend 

vsig: synchronize a co- 

checklist: list of filesystems 

a signal to a process or a group of 
killall: kill all active 

return number of child 
m_kill_procs: kill child 
m_set_procs: set number of child 
fuser: identify 

m4: macro 

menu: menu 

tmp_affinity: bind a process to a 
tmp_ctl: multi- 

priority aging, PFF, swapping, or 
offline_all: take all but one active 
pdp11, u3b, u3b2, u3b5, vax: get 
online, offline: bring 

romap; map an open file into the 
munmap: unmap part of the 
pmap: map physical addresses into 


monitor: prepare execution 
profil: execution time 

prof: display 

at login time 

prof: 
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process attributes 
process code section.. 
process communication facilities sta! 
process contro] initialization....... 


...proc_ctl(2SEQ) 
m_single(3PPS) 
-ipea(1) 
init(1M) 


process data and system activity .timex(1) 
process execution... m_park_proca(3PPS) 
process group ..8etpgrp(1) 
process group, and parent process IDs. getpid(2) 


PYOCEBB QTOUP ID....s.ssscsessssssecrsserssecceeres ..Betpgrp(2) 
process group ID... + 8etsid(2) 
process group ID ..tegetpgrp(2) 
process group ID.... ..tesetpgrp(2) 
process identification... m_get_myid(3PPS) 
process IDs getpid(2) 


process in a virtual memory efficient way 
process or a group of processes. 
process, process group, and paren 


..vfork(2) 


process status....... ssceresaast CCT -»ps(1) 
process, text, or data in memory.. plock(2) 
process times... aes .times(2) 
process to a processor.. p_affinity(2SEQ) 
process to stop or terminate... + Wait(2) 
process trace facility......... a ptrace(2) 
process until signal.........sssssssses pause(2) 
process with the controlling FMLI object... vsig(1F) 
processed by fsck and ncheck checklist(4) 
processes -kill(2) 
processes -killall(1M) 
processes... m_get_numprocs(3PPS) 
processes.. m_kill_proca(3PPS) 
PYOCEBSES..ssssseecsessnssececoereseees aaivisataieasesed ....20_set_procs(3PPS) 
processes using a file or file structure 

processor... 

processor... ql 
processor.. mp_affinity(2SEQ) 


processor control... 
processor migration disabled. 
processor Off line... 
processor type truth value. 
processors online and offline 
processs address space 
processs address space.... 
processs virtual address space.. 
product: installed products file. 
prof: display profile data 
prof: profile within a function. 
profil: execution time profile 
profile.. 


tmp_ctl(2SEQ) 
...-noage(1M) 
offline_all(3SEQ) 
..machid(1) 


“monitor(3C) 


profile .-profil(2) 
profile data. -prof(1) 
profile: setting up an environment. profile(4) 
profile within a function.........0+ .««.prof(5) 
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end, etext, edata: last locations in 
mt: magnetic tape manipulating 
prompt: prompt 

sdiff: side-by-side difference 
STREAMS error logger cleanup 

units: conversion 

for the uucp file transport 

assert: verify 

ASSIST menus or command/ astgen: 
uucico: file transport 

installboot: installs a boot 

boot: run a standalone 

a standard/restricted command/ 

the standard/restricted command 
intro: introduction to Parallel 
maintenance commands and application 
update, and regenerate groups of 
lex: generate 

setlocale: set 

prompt: 


t_getinfo: get 
proto: 


/monacct, nulladm, pretmp, prdaily, 
device 
standalone disk device 


streampty: STREAMS 

getpseudotty: get 

cn: 

generate uniformly distributed 
time, 

facility 

uuto, uupick: 

ungete: 

puts, fputs: 

pute, putchar, fputc, putw: 
getdents: read directory entries and 
echo: 

character or word on a stream 

or word on a stream pute, 
environment 


stream 

message: 

entry 

getut: getutent, getutid, getutline, 
pute, putchar, fpute, 

checkers 


program assertion. 
program for generating/modifying... 
program for the uucp system. 
program on a disk 
program or bring up the operating system... 
programming language. 
programming language 
Programming Library.. 
programs... 
programs.... 
programs for simple lexical tasks. 
programs location... 
prompt program.., 
prompt: prompt program. 
proto: prototype job file for at. 
protocol-specific service information 
prototype job file for at. 
prs: print an SCCS file... 
prtacct, shutacct, startup, 
prtvtoc: print the VTOC of a block 
prtvtoc: print the VTOC of a. 
ps: report process status... 
pseudo terminal driver. 
pseudo terminala....... 
pseudoconsole driver. 
pseudorandom numbers... 
ptime: time a command 
ptrace, mptrace: process trace 
public UNIX-to-UNIX system file copy. 
push character back into input stream... 
put a string on a StreaM.....sserseeceeeee 
put character or word on a stream... 
put ina file system independent/.... 
put string on virtual output... 
pute, putchar, fputc, putw: put 
putchar, fputc, putw: put character.. 
putenv: change or add value to.. 
putmsg: send a message on a stream... 
putpwent: write password file entry. 
puts, fputs: put a string on a... 
puts its arguments on message line. 
putspent: write shadow password file.. 
pututline, setutent, endutent/........... 
putw: put character or word on a stream. 
pwek, grpck: password/group file. 


-prompt(1M) 
.prompt(1M) 
os proto(4) 
..t_getinfo(3N) 
.proto(4) 


.prtvtoc(1M) 
.prtvtoc(8) 


.. ptrace(2) 
.uuto(1C) 


"putenv(3C) 
... putmsg(2) 
.putpwent(3C) 
..-puts(3S) 
essage(1F) 
..putspent(3X) 
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/etc/shadow with information from/ 


database creation 
password entries 
one password file scheme 


tput: initialize a terminal or 

route user message to menu message 
msgget: get message 

Ipusers: set printing 

iperm: remove a message 
quotacheck: filesystem 


consistency checker 


quotaon, 

quotas on and off 

edquota: edit user 

quotactl: manipulate disk 
repquota: summarize 

quotaon, quotaoff: turn filesystem 
generator 

feirand: install 

rand, srand: simple 

feplit: split [77, 


ratfor: 

scripts 

the operating system 
multi-user environment 


resintro: introduction to 

resfile: format of 

rcs: change 

sccstores: build 

messages and other information about 
ci: check in 

co: check out 

resdiff: compare 

resmerge: merge 


commands 


getpass: 

of a common object file ldtbread: 
header of a/ ldshread, ldnshread: 
structure read_constab: 
file system independent/ getdents: 
read: 

mail, rmail: send mail to users or 
line: 
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pweonv: installs and updates.... 
pwd: working directory name... 
pwdhd: daemon to oversee password... 
pwfix: remove incorrectly formatted. 
pwunconv: converts from a two to a.... 
qsort: quicker sort 
query terminfo database 
queue.. 
queue. 
queue priorities... 
queue, semaphore set, or shared memory ID. 
quota consistency checker........ssssessssseeersseees quotacheck(1M) 
quota: display disk usage and limits... quota(1) 
quotacheck: filesystem quota........ .quotacheck(1M) 
quotactl: manipulate disk quotas quotactl(2SEQ) 
quotaoff: turn filesystem quotas on and off.....quotaon(1M) 
quotaon, quotaoff: turn filesystem. quotaon(1M) 


-menumsg{ 1M) 
.msgget(2) 


quotas... edquota(1M) 
quotas... quotactl(2SEQ) 
quotas for a filesystem ..repquota(1M) 


quotas on and off.......... 
rand, srand: simple random-number. 
random inode generation numbers........ 
random-number generator 
ratfor, or eff files .......ccse0ees 
ratfor: rational Fortran dialect. 
rational Fortran dialect...... 
re: reboot and shutdown command. 
rc0: run commands performed to stop 
re2: run commands performed for........ 
res: change RCS file attributes.. 
RCS commands. 


quotaon(1M) 
..rand(3C) 
..fsirand(1M) 


RCS file attributes. ..res(1) 
RCS file from SCCS file. secstorcs(1) 
RCS files........00. rlog(1) 


RCS revisions... weeeCH(1) 
RCS revisions .........secccrecsoresessosessesesesscensseecensseensnsnessevenente co(1) 
RCS revisions.. resdiff{1) 
RCS revisions.. resmerge(1) 


resdiff: compare RCS revisions... 
resfile: format of RCS file........ 
resintro: introduction to RCS. 
resmerge: merge RCS revisions. 
read a password 
read an indexed symbol table entry. 
read an indexednamed section. 
read constab entries into a..... 
read directory entries and put in a.. 
read from file... 
read mail..... 
read one line ........sssss00 fe 


.read_constab(8SEQ) 
...getdents(2) 
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ldahread: 
ldfhread: 
readlink: 

readv: 

into a structure 
directory: opendir, 
gets longest line 
open a common object file for 
open: open for 
link 

readfile, longline: 


of an archive file 
object file 


Iseek: move 

tirdwr: Transport Interface 
/get real user, effective user, 
/geteuid, getgid, getegid: get 
malloc, free, 
malloc, free, 
re: 
t_revudata: 
t_revuderr: 


fast main memory/ 


over a connection 
connect request 


setcolor: 
ditsectbl: 
regular expression 


make: maintain, update, and 
expression regemp, 
string 

and match routines 

regemp, regex: compile and execute 
regemp: 

regexp: 

a file for a pattern using full 


routines 


accept, 

comm: select or 

join: 

t_sndrel: initiate an orderly 
acknowledge receipt of an orderly 
common object file 

ldrseek, ldnrseek: seek to 
reloc: 

/ceil, fmod, fabs: floor, ceiling, 
calendar: 

uuxqt: execute 

Uutry: try to contact 

ct: spawn getty toa 
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; receive data or expedited data sent. 
: receive the confirmation from a... 


read(2) 
..ldahread(3X) 
..ldfhread(3X) 
.readlink(2SEQ) 
eeaned readv(2SEQ) 
read. a ocr 


read: read from file 
read the archive header of a member... 
read the file header of a common. 
read value of a symbolic link.. 
read vector from file...........00 
read_constab: read constab entries... 
readdir, telldir, seekdir, rewinddir/. 
readfile, longline: reads file and... 


..ldopen(3X) 
....open(2) 
.readlink(2SEQ) 
readfile(1F) 
jensen 


readlink: read value of a symbolic 
reads file and gets longest line .. 
readv: read vector from file 
read/write file pointer........ 
read/write interface STREAMS module 
real group, and effective group IDs 
real user, effective user, real/............ oe 
realloc, calloc: main memory allocator 
realloc, calloc, mallopt, mallinfo........... 
reboot and shutdown command scripts... 
receive a data unit... 
receive a unit data error indication 


»-malloc(3C) ° 
""malloc(3X) 


_revuderr(3N) 
ssnsese t_rev(3N) 
..t_revconnect(3N) 
record locking on files... 


red: text editor .......+ asa diseseSevaaeas aude badeazachssncaiseascssbasttosel ed(1) 
redefine or create a color. setcolor(1F) 
refresh security table...... .dltsectbl(1M) 
regcemp, regex: compile and execute se ee 


regcemp: regular expression compile 
regenerate groups of program....... 
regex: compile and execute regular. 
regex: match patterns against a.. 
regexp: regular expression compile... 
regular expression......006 
regular expression compile 
regular expression compile and match 
Tegular expressiONS......vsssseeeereee 
reinit: run an initialization file.. 
reject: allow or prevent LP requests 
reject lines common to two sorted files 
relational database operator 
release.. 
release indication, 

reloc: relocation information for a. 
relocation entries of a section of a common/.. 
relocation information for a common object file 
remainder, absolute value functions... 
reminder Bervice........0+ 
remote command requests. 
remote system with debugging on 
remote terminal 


-accept(1M) 
..comm(1) 
.join(1) 
_sndrel(3N) 
t_revrel(3N) 


.calendar(1) 
..uuxqt(1M) 
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rmdel: 
mndir: 
rmvopt: 
iperm: 
unlink: 
rm, rmdir: 
pwfix: 
deroff: 


set, or shared memory ID 


password entries 


consistency check and interactive 
uniq: report 
clock: 
fastat: 

ipes: 

df: 

mailbug: submit a bug 

sar: sal, sa2, sadc: system activity 
timex: time a command; 

ps: 

uniq: 

fseek, rewind, ftell: 

filesystem 

submit a bug report or enhancement 
t_accept: accept a connect 

t_listen: listen for a connect 

the confirmation from a connect 
send user-initiated disconnect 

accept, reject: allow or prevent LP 
the LP print service and move 
uuxqt: execute remote command 

Ip, cance): send/cancel 
to its default values 
reset: 
get_process_stats: get 
restore: incremental filesystem 
restore 

/ksh, rksh — KornShell, a standard/ 

sh, reh: shell, the standard/ 

shadow: 

/m_rele_procs: suspend and 

usage examples usage: 
t_revdis: 

object file symbol table/ Idgetname: 
abs: 

logname: 

m_get_numprocs: 

m_get_myid: 
getenv: 

stat: data 
getitems: 
getfrm: 
cpus_online: 


facilities status 


default values 


marked menu items 


DYNIX/ptx Reference Manual 


remove a delta from an SCCS file. 
remove a directory........ 
remove a menu option.. 
remove a message queue, semaphore. 
remove directory entry... 
remove files or directories .. 
remove incorrectly formatted 
remove nroff, tbl, and eqn constructs. 
rename: change the name of a file 


repeated lines in a file. 
report CPU time used... 
report filesystem status.. 
report inter-process communication 
report number of free disk blocks and inodes.. 
report or enhancement request. 
TEport package wrscsssscseseene eee 
report process data and system activity. 
report process status... 
report repeated lines in a file.... 
reposition a file pointer in a stream 
repquota: summarize quotas for a 


requests. 

requests to the LP print SETViCEe ..sssssessesssssssssesseessesseesveen -lp(1) 
reset: reset the current form field reset(1F) 
reset the current form field to its.. reset(1F) 


resource utilization info.. 


restore: incremental filesystem 
restricted command and programming/. 
restricted command programming/. 
restricted password file.............. 
resume child process execution 
retrieve a command description oie 

retrieve information from disconnect.. 
retrieve symbol] name for common... 
return integer absolute value 
return login name of user... 


ogname(3X) 


return number of child procs. ‘m_get_numprocs(3PPS) 
return process identification... sseeeee_get_myid(3PPS) 
return value for environment name 

returned by stat system call... 


returns a list of the currently.. 
returns the current frame number.. 
returns the number of CPUs on-line. 
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col: filter 

ci: check in RCS 

co: check out RCS 

resdiff: compare RCS 

resmerge: merge RCS 

pointer in a stream feeek, 
/opendir, readdir, telldir, seekdir, 
creat: create a new file or 

restricted command/ ksh, 
information about RCS files 
directories 

mail, 

file 


rm, 


chroot: change 

chroot: change 

logarithm, power, square 

queue menumsg: 
l1dfcn: common object file access 
regular expression compile and match 
programming language sh, 
nice: 

nohup: 

shell: 

noage, nopff, noswap, onproc: 

the operating system boot: 
run: 
ede: 
reinit: 
setpgrp: 
re2: 
rc0: 
runacct: 


multi-user environment 
operating system 


Administration 
sar: 

sar: sal, 
editing activity 
sar: sal, sa2, 
report package 


savecore: 
operating system 
brk, 

brk, 

formatted input 
bfs: big file 

awk: pattern 
nawk: pattern 


rewind, ftell: reposition a file... 
rewinddir, closedir: directory/. 


rksh: KornShell, a standard/.... 
rlog: print log messages and other. 
rm, rmdir: remove files OF.........0s« 
rmail; send mail to users or read mail. 
rmdel: remove a delta from an SCCS. 
rmdir: remove a directory......0 
rmdir: remove files or directories... 
rmvopt: remove a menu option 


root directory for a command... 


TOOt FUNCIONS.....c0cssssrersessesecerers 
.menumsg(1M) 


— Idfen(4) 


rsh: shell, standard/restricted command/.. 
run a command at low priority... sass 
run a command immune to hangups ‘and quits.. 
run a command using shell.. 
run a command with priority aging, 
run a standalone program or bring up.. 
TUD BN CXECULADLE......cssscesseeseesseeeeresees 
run an externally described command... 
run an initialization file. 
run command in its own process group. 
run commands performed for... 
run commands performed to stop the. 
run daily accounting... 
run: run an executable... 
runacct: run daily accounting... 
SA: devices administered by System. 
sal, sa2, sadc: system activity report package 
ga2, sade: system activity report package. 
sact: print current SCCS file......sssssee 
sadc: system activity report package... 
sar: sal, sa2, sadc: system activity. 
sar: system activity reporter. 
save a core dump of the operating system. 
savecore: save a core dump of the. 
sbrk: change data segment space allocation. 
sbrk: change private data segment size.. 
scanf, fscanf, sscanf: convert .. 
BOADCT ssenscrrsiccassasscasansssrenneeaven 
scanning and processing language... 
scanning and processing language... 


scan{(3S) 
..bfs(1) 
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change the delta commentary of an 
comb: combine 

delta: make a delta (change) to an 
get: get a version of an 

prs: print an 

rmdel: remove a delta from an 
scesdiff: compare two versions of an 
sccsfile: format of 

sccstorcs: build RCS file from 
unget: undo a previous get of an 
val: validate 

sact: print current 

admin: create and administer 
what: identify 

SCCS file 


file 

board 

ckbupscd: check filesystem backup 
transport program uusched: the 
unlock locks s_init_lock, s_lock, 
object file 

image file 

more: view a file one full 

curses: terminal 

scr_dump: format of curses 

vi: 

inittab: 

rc: reboot and shutdown command 
tg: 

sd: 

wd: SSM 

CCSformat: standalone embedded 
tm: 


ts: SCSI tape controller. 


* SCED: 
getscsiinfo, getscsimatch: get 


program 

fgrep: 

grep: 

full regular expressions egrep: 
bsearch: binary 

acctcom: 

lsearch, lfind: linear 

pathconv: 

hereate, hdestroy: manage hash 
tfind, tdelete, twalk: manage binary 
manipulate the object file comment 
m_multi: mark single-process code 
senhdr: 

Adnshread: read an indexednamed 
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sccsdiff: compare two versions of an... 
sccsfile: format of SCCS file.......... 


.ckbupsed(1M) 
uusched(1M) 
gee 


cp 
s_clock, s_unlock: initialize, lock, 
senhdr: section header for a common. 
scr_dump: format of curses screen., 
SCTEEN At B CIME.....s.ssscsssrsesseersssseenseserseees 
screen handling and optimization package.. 
screen image file .......ssssssssseeseeen sssseserevsosereneesevene SCP_GUIMP(4) 
screen-oriented (visual) display editor based on ex......vi(1) 
script for the init process... -inittab(4) 
BCTUPES wssesersesssicnncscnnssnesiin -TC(4) 
SCSI 1/2-inch magnetic tape interface... .tg(7) 
SCSI disk controller.. --8(7) 
SCSI disk controller. 
SCSI disk formatter... 
SCSI tape controller. 


-tm(7) 


scsiinfo structure 


sdiff: side-by-side difference... 
search a file for a character strin, 


search a file for a pattern... .grep(1) 
search a file for a pattern using. egrep(1) 
search a sorted table... bsearch(3C) 


search and print process accounting files... 
search and update.., 
search Interpreter criteria for filename. 
search tables. 
search trees, 
BECCION seese0ee 


“Jsearch(3C) 
..pathconv(1F) 
hsearch(3C) 
.tsearch(3C) 


section header for a common object file. 
section header of a common object/ 
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/seek to line number entries of a 
/seek to relocation entries of a 
Adnsseek: seek to an indexednamed 
ditsectbl: refresh 

task: global 

tasktbl: create 


/nrand48, mrand48, jrand48, srand48, 
acommon object/ Idsseek, ldnsseek: 


section of a/ ldlseek, Idnlseek: 
ldrseek, Idnrseek: 
a common object file ldohseek: 


ldtbseek: 

/opendir, readdir, telldir, 
sweepoff: enable/disable patrol 
shmget: get shared memory 

brk, sbrk: change private data 
shbrk, shsbrk: change shared data 
brk, sbrk: change data 
comm: 

greek: 

addformopt: add a form/ 
semctl: 

semop: 

iperm: remove a message queue, 
semget: get set of 


object file 


sorted files 


t_sndudata: 
putmsg: 
kill: 
tfnotify: 
t_snd: 

mail, rmail: 
t_snddis: 
Ip, cancel: 
receive data or expedited data 
intro: introduction to 

dis386: disassemble 

SSM: System 

setsid: create 

ascii: map of ASCII character 
alarm: 

umask: 

stty, gtty: 

set, unset: 

sigstack: 

timezone: 
backup.info: backup 
setdtablesize: 

env: 


connection 


in core or in files 
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section of a common object file... 
section of a common object file. 
section of a common object file. 
security table... 
security table... 
security table in shared memory. 


Bed: stream CditOL ........ssssscscesssssscecscsecasseserscsscaceceerecseese sed(1) 
seed48, lcong48: generate uniformly/. drand48(3C) 
seek to an indexednamed section of.. dsseek(3X) 
seek to line number entries of a..... diseek(3X) 
seek to relocation entries of a section of a/........ldrseek(3X) 


seek to the optional file header of 
seek to the symbol table of a common. 
seekdir, rewinddir, closedir/. 


seeks on DCC disks sweepon(1M) 
segment identifier. -shmget(2) 
segment size. -brk(3PPS) 
segment size.. shbrk(3PPS) 
segment space allocation.. we brk(2) 
select or reject lines common to two.. comm(1) 
select terminal filter.......ssssse00 a ve greek(1) 
SELECT window option to a menu.. .addformopt(1M) 
semaphore control operations. ...semctl(2) 
semaphore Operations ........s.000 semop(2) 
semaphore set, or shared memory ID iperm(1) 
BEMAPNOTES wrssssevssssesereessensvensncarereneerenes ..semget(2) 
semctl: semaphore control operations. semct](2) 
semget: get set of semaphores. ..semget(2) 
semop: semaphore operations. -.semop(2) 
send a data unit.......00 or __sndudata(3N) 
send a message on a stream... . putmsg(2) 


send a signal to a process or a group of processes......kill(2) 
send completion message... 
send data or expedited data over a 
send mail to users or read mail...... 
send user-initiated disconnect request. 
send/cancel requests to the LP print service. 


sent over a connection... t_rev(3N) 


Sequent system calls... -intro(2SEQ) 
Series 386 instructions... .dis386(3SEQ) 
Services Module............. .ssm(7) 
session and set process group ID.. setsid(2) 
BO cecescsseressssesersenscessseesesor: ascii(5) 
set a process alarm clock alarm(2) 
set and get file creation mask...... mask(2) 


set and get terminal state (defunct; 


set default system time zone 


set definitions.............. ackup_info(4) 
set descriptor table size. etdtablesize(2SEQ) 
set environment for command exeCutiOn...r.ceeeererres env(1) 
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utime: 

umask: 

tesetpgrp: 

setgroups: 

cpset: copy file and 

m_set_procs: 

semget: get 

remove a message queue, semaphore 
Ipusers: 

setpgrp: 

setsid: create session and 

setlocale: 

tabs: 

tegetattr, tesetattr: get/ 

line discipline getty: 
line discipline uugetty: 
date: print and 

stty: 

stime: 

environment variables in core or in/ 


setuid, setgid:” 


ulimit: get and 
a stream 
/toascci, __tolower, _toupper,. 


size 
setuid, 
getgrent, getgrgid, getgrnam, 


crypt, 


/endmntent, getmntent, hasmntopt, 
process group 


getpwent, getpwuid, getpwnam, 
process group ID 

getspent, getspnam, 

profile: 

gettydefs: speed and terminal 
IDs 

user 

/getutid, getutline, pututline, 
setbuf, 

machine-independent fashion sputl, 
standard/restricted command/ 
MAgetspent, Ickpwdf, ulckpwdf: get 
putspent: write 


pwconv: installs and updates /etc/ 
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set file access and modification times... 
set file-creation mode mazsk....... 
set foreground process group ID 
set group access list........ evaatess 
set mode, user, and group IDs. 
set number of child processes. 
set of semaphores... 
set, or shared memory ID 
set printing queue priorities. 
set process group ID... 
set process group ID... 
set programs location 
set tabs on a terminal.. 
set terminal state..... 
set terminal type, modes, speed, and.. 
set terminal type, modes, speed, and.. 
set the date ......scecserssscersseees 


eee __iperm(1) 


Sescaa taba(1) 
.tegetattr(2) 


set the options for a terminal ...8tty(1) 
set time.. ..8time(2) 
set, unset: set and unset... ..et(1F) 
set user and group IDs. setuid(2) 
set user limits............ ulimit(2) 
setbuf, setvbuf: assign buffering to.. setbuf(3S) 
setchrclass: character handling... ..ctype(3C) 
setcolor: redefine or create a color... ‘setcolor(1F) 


setdtablesize: set descriptor table....... setdtablesize(2SEQ) 
setgid: set user and Qroup IDB.....s0cesereees setuid(2) 
setgrent, endgrent, fgetgrent: get group/. 
setgroups: set group access list. 
setjmp, longjmp: non-local goto... 
setkey, encrypt: generate hashing encryption......crypt(3C) 
setlocale: set programs location... 
setmnt: establish mount table 
setmntent: get file system/. 
setpgid: manipulate signal sets 
setpgrp: run command in its own. 
setpgrp: set process group ID.. 
setpwent, endpwent, fgetpwent: ge 


..getmntent(3SEQ) 
...setpgid(2) 


setsid: create session and SC... ..8etsid(2) 
setspent, endspent, fgetspent, Ickpwdf/.. getspent(3X) 
setting up an environment at login time ..profile(4) 
settings used by getty...secssesee .gettydefa(4) 


setuid, setgid: set user and group. 
setup: initialize system for first 
setutent, endutent, utmpname/... 
setvbuf: assign buffering to a stream. 
sgetl: access long integer data in a... 
sh, rsh: shell, the 


shadow password file entry getspent(3X) 
shadow password file entry... putspent(3X) 
shadow: restricted password file.. 
shadow with information frond... 


Permuted Index 


shbrk, shsbrk: change 

tasktbl: create security table in 
shmalloc, shrealloc, shfree: 
shmctl: 

@ message queue, semaphore set, or 
shmop, shmat, shmdt: 

shmget: get 

segment size 

shell: run a command using 
assign menu system as user login 
system: issue a 

csh: a 

/shutacct, startup, turnacct: 


shells: 

command programming/ sh, rsh: 
shmalloc, shrealloc, 
memory allocator 
shmop, 

operations 

shmop, shmat, 
identifier 
operations 

the machine 
shmalloc, 

shbrk, 

shutdown: 
/nulladm, pretmp, prdaily, prtacct, 
re: reboot and 

shutdown: system 

system state 

information file 

actions 

manipulate/ sigemptyset, sigfillset, 


allocator 


sigemptyeet, sigfillset, sigaddset, 
sigdelset, sigismember: manipulate/ 
sigismember/ sigemptyset, 
sigpause: signal management sigset, 
sigset, sighold, sigrelse, 

/sigfillset, sigaddset, sigdelset, 
sigsetjmp, 

login: 

pause: suspend process until 

specify what to do upon receipt of a 
sigsuspend: wait for a 

sigaction: examine and change 
sigcontext: get 

sigrelse, sigignore, sigpause: 
setpgid: manipulate 

sigdelset, sigismember: manipulate 
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shared data segment size 

shared MeEMOLY........e0+ 

shared memory allocator shmalloc(3PPS) 
shared memory control operations. shmct](2) 


shared memory ID.........++ 
shared memory operations... 
shared memory segment identifie 
shbrk, shsbrk: change shared data 


...-shell(1F) 
fmenush(1M) 
system(3S) 
shell (command interpreter) with C-like syntax........ csh(1) 
shell procedures for accounting... .acctsh(1M) 
shell: run a command using shell... -shell(1F) 
Bhell table....sccscsssssvseeseeseseseres .Shells(4) 
shell, the standard/restricted. ..sh(1) 
shells: shell table .......sssesesssseee ..Shells(4) 
shfree: shared memory allocator. 
shmalloc, shrealloc, shfree: shared... 
shmat, shmdt: shared memory operations. 
shmctl: shared memory control........ 
shmdt: shared memory operations 
shmget: get shared memory segment.. 
shmop, shmat, shmdt: shared memory 
showcefg: show the configuration of... 
shrealloc, shfree: shared memory.. 
shsbrk: change shared data segment size 
shut down system, change system state... 
shutacct, startup, turnacct: shell/. 
shutdown command scripts. 
shutdown information file... 
shutdown: shut down system, change .. 
shutdown: system shutdown........000 
sigaction: examine and change signal . 
sigaddset, sigdelset, sigismember: 
sigcontext: get signal context. 
sigdelset, sigismember: manipula 


..sigemptyset(2) 
.sigcontext(2SEQ) 
..sigemptyset(2) 


sigemptyset, sigfillset, sigaddset, ..sigemptyset(2) 
sigfillset, sigaddset, sigdelset, ..Sigemptyset(2) 
sighold, sigrelse, sigignore...... 8igset(2) 
sigignore, sigpause: signal/........ Sigset(2) 
sigismember: manipulate signal sets... ..sigemptyset(2) 
siglongjmp: non-local jumps sigsetjmp(3C) 
BI QD OD cessescssenssoeeers .login(1) 
signal. .-pause(2) 
BIQMAL .....sessssssecsssssescesssessssnsonensenscaconsnvensenencensgncaneatences signal(2) 
signal. sigsuspend(2) 
signal actions... ...Sigaction(2) 
signal context.. .sigcontext(2SEQ) 
signal management... ..Sigset(2) 
signal sets... setpgid(2) 
signal sets.... ..-sigemptyset(2) 
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receipt of a signal 

sigstack: set and/or get 

kill: send a 

sigpending: examine pending 
examine and change blocked 
ssignal, gsignal: software 
sighold, sigrelse, sigignore, 


blocked signals 

signal management sigset, sighold, 
sigignore, sigpause: signal/ 

jumps 

stack context 


atan2: trigonometric/ trig: 
m_single, m_multi: mark 
functions 


initialize barrier, wait at barrier: 


s_unlock: initialize, lock, unlock/ 
sbrk: change private data segment 
getdtablesize: get descriptor table 
getpagesize: get system page 
setdtablesize: set descriptor table 
shsbrk; change shared data segment 
of object files 

interval 

interval 

s_init_lock, 

ttyslot: find the 

consmem, 

ssignal, gsignal: 

qsort: quicker 

tsort: topological 

sort: 


select or reject lines common to two 
bsearch: binary search a 
an object file list: produce C 


open file into the processs address 
unmap part of the processs address 
into processs virtual address 

brk, sbrk: change data segment 

ct: 

vfork: 

fepec: format 
signal: 
getty: set terminal type, modes, 
uugetty: set terminal type, modes, 
gettydefs: 

find spelling errors 

file 


memory efficient way 
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signal: specify what to do upon... 
signal stack context. 
signal to a process or a group of processes 


sigpause: signal management. 
sigpending: examine pending signals 
sigprocmask: examine and change. 
sigrelse, sigignore, sigpause: 
sigset, sighold, sigrelse,..... 
sigsetjmp, siglongjmp: non-local... 
sigstack: set and/or get signal. 
sigsuspend: wait for a signa)... 
sin, cos, tan, asin, acos, atan, 
single-process code section... 
sinh, cosh, tanh: hyperbolic. 
s_init_barrier, s_wait_barrier: 
s_init_lock, s_lock, s_clock, 


sigset(2) 
sigset(2) 


....brk(3PPS) 
.getdtablesize(2SEQ) 
getpagesize(2SEQ) 
.setdtablesize(2SEQ) 
—— shbrk(3PPS) 
..8ee C and Lang Tools Binder 


size: print section sizes... 


sleep: suspend execution for an... -sleep(1) 
sleep: suspend execution for..... ..Bleep(3C) 
s_lock, s_clock, s_unlock: initialize, lock/.......8_lock(3PPS) 
slot in the utmp file of the current user. .ttyslot(3C) 
8m, 8s: console memory drivers .consmem(7) 
software signals... ssignal(3C) 


-bsearch(3C) 
.see C and Lang Tools Binder 


.munmap(2SEQ) 
pmap(7) 
brk(2) 
spawn getty to a remote terminal ct(1C) 
spawn new process in a virtual 
specification in text files........... 
specify what to do upon receipt of a signal 


.fspec(4) 
..-8ignal(2) 


speed, and line discipline... .getty(1M) 
speed, and line discipline... uugetty(1M) 
speed and terminal settings used by getty........gettydefs(4) 


spell, hashmake, spellin, hashcheckz... 
spellhist: unmatched spelling words.. 


Permuted Index 


a 


spell, hashmake, 

hashmake, spellin, hashcheck: find 
spellhist: unmatched 

cesplit: context 

split: 

feplit: 


uucleanup: uucp 

printf, fprintf, 

data in a machine-independent/ 
square root/ exp, log, log10, pow, 
sqrt: exponential, logarithm, power, 
rand, 

Arand48, nrand48, mrand48, jrand48, 
consmem, sm, 

scanf, fecanf, 


wp: 


wd: 


termina] multiplexor driver 
sigstack: set anW/or get signal 

copy: perform a 

prtvtoc: print the VTOC of a 
dual-channel disk/ zdformat: 
CCSformat: 

dump: 

operating system boot: run a 
intro: introduction to system 
stdio: 

stdipe: ftok: 

sh, rsh: shell, the 

operating system for beginning/ 
Ipsched, Ipshut, Ipmove: 

/pretmp, prdaily, prtacct, shutacct, 
cal] 


package 


stat: data returned by 
information 

ustat: get filesystem 

ff: list filenames and 

fastat: report filesystem 
communication facilities 
ps: report process 

stat, Istat, fatat: get file 
feof, clearerr, fileno: stream 
uustat: uucp 

Ipstat: print information about the 
input/output package 
communication package 


waitpid: wait for a child process to 
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spellin, hashcheck: find spelling errors spell(1) 
spelling errors....... ..spell(1) 
spelling words file spellhist(4) 
split...... ..csplit(1) 
split a file into pieces.. split(1) 


split f77, ratfor, or efi files fsplit(1) 


split: split a file into pieces... .Split(1) 
spool directory clean-UP........004 .uucleanup(1M) 
sprintf: print formatted output .printh3S) 
sputl, sgetl: access long integer... sputl(3X) 
sqrt: exponential, logarithm, power,. ..exp(3M) 
square root functions .exp(3M) 
srand: simple random-number generator -rand(3C) 
srand48, seed48, lcong48: generate/.. .drand48(3C) 


gs: console memory drivers... 
sscanf: convert formatted input.. 
ssignal, gsignal: software signals. 
SSM parallel line printer interface 
SSM SCSI disk controller.......... 
SSM: System Services Module . 
st: Systech MTI-800/1600/1650 
stack context. 
standalone data transfer. 
standalone disk device........ 
standalone disk formatter for.. 
standalone embedded SCSI disk formatter..... 
standalone memory dUMP........0 ae 
standalone program or bring up the.. 
standalone utilities. 
standard buffered input/output package. 
standard interprocess communication.... 
standard/restricted command programming/. 
starter: information about the.... 
start/stop the LP print service and move/ 
startup, turnacct: shell procedurey/... 
stat: data returned by stat system.... 
stat, stat, fetat: get file status. 
stat system Call .....ssesseseeeees 
statfa, fatatfs: get filesystem 
StAtIStiCe.......sssesceee 
statistics for a filesystem... 


..Starter(1) 
.. psched(1M) 
.acctsh(1M) 
.stat(5) 


status... 

status. -ipes(1) 
status, «ps(1) 
status. .stat(2) 
status inquiries. ferror(3S) 
status inquiry and job control . -uustat(1C) 
status of the LP print service ..lpstat(1) 
stdio: standard buffered........ .stdio(3S) 
stdipe: ftok: standard interprocess.. tdipe(3C) 
stime: set time....... .stime(2) 


stop or terminate. 
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Ipsched, Ipshut, lpmove: start/ 
re0: run commands performed to 
icheck: filesystem 


strncmp, strepy, strncpy,/ string: 
/strncmp, strepy, strnepy, strlen, 
cleanup program 

string: streat, strdup, strncat, 
/strdup, strncat, stremp, strncmp, 
/strehr, strrchr, strpbrk, strspn, 
strepy, strncpy,/ string: streat, 
fclose, flush: close or flush a 

fopen, freopen, fdopen: open a 
reposition a file pointer in a 

getw: get character or word from a 
getmsg: get next message off a 

gets, fgets: get a string from a 

putw: put character or word on a 
putmsg: send a message on a 

puts, fputs: put a string on a 

setvbuf: assign buffering to a 

push character back into input 

sed: 

ferror, feof, clearerr, fileno: 


driver 

clone: open any minor device on a 
strclean: 

strerr: 

log: interface to 

poll: 

streamio: 

Transport Interface cooperating 
Interface read/write interface 
Bp: 

streampty: 

strace: print 

streamtty: Generic 

1d0: 

driver interface 


long integer and base-64 ASCII 
tzset: convert date and time to 
convert floating-point number to 
fgrep: search a file for a character 
regex: match patterns against a 
gps: graphical primitive 

gets, fgets: get a 

puts, fputs: put a 

echo: put 

strpbrk, strspn, strespn, strtok: 
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stop the LP print service and move/. 
stop the operating system... 
storage consistency check... 
strace: print STREAMS trace messages.. 
streat, strdup, strncat, stremp.,..... 
strehr, strrehr, strpbrk, strapn/ 
strclean: STREAMS error logger... 
strcmp, stracmp, strepy, strncpy,/ 
strepy, strncpy, strlen, strchr/...... 
strespn, strtok: string operations.. 
strdup, strncat, strcmp, strncmp,. 
stream... 


-lpsched(1M) 


stream 

stream... 

stream.. 

stream., 

stream., +. Bets(3S) 
stream -».pute(3S) 
stream . putmsg(2) 
stream, +. puts(3S) 
stream .setbuf{3S) 
BLTEAM.......000 

stream editor... 


stream status inquiries....... 
streamio: STREAMS ioctl commanda.... 
streampty: STREAMS pseudo terminal... 
STREAMS Giver ......ssessesoeee aatbaeneaanasasel 
STREAMS error logger cleanup program. 
STREAMS error logger daemon. ......ssssssee 
STREAMS error logging and event tracing 
STREAMS input/output multiplexing.. 
STREAMS ioctl commands. 
STREAMS module... 
STREAMS module... 
STREAMS pipe device. 
STREAMS pseudo terminal driver. 
STREAMS trace messages........ 
STREAMS tty driver interface 
STREAMS tty line discipline... 
streamtty: Generic STREAMS tty. 
strerr: STREAMS error logger daemon 
strftime: format time information... 


a641(3C) 
.ctime(3C) 


string... ecvt(3C) 
string... fgrep(1) 
BEING. .ccsesessesssessecerecesseses regex(1F) 
string, format of graphical files. ++ §ps(4) 
string from a stream. gets(3S) 
string on a stream...... puts(3S) 


string on virtual outpu' 
string operations........... 
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stremp, strncmp, strepy, strncpy,/ 
strtod, atof: convert 

strtol, atol, atoi: convert 

cftime: language specific 

object file 

/stremp, strncmp, strepy, strncpy, 
string: streat, strdup, 

/streat, strdup, strncat, stremp, 
/strncat, stremp, strncmp, strepy, 
/strncpy, strlen, strchr, strrchr, 
/strepy, strncpy, strlen, strchr, 
/strlen, strchr, strrchr, strpbrk, 
character 

double-precision number 

strrehr, strpbrk, strspn, strespn, 
to integer 

processes using a file or file 
getscsimatch: get scsiinfo 
getzdinfobyname: get zdinfo 

read constab entries into a 
t_alloc: allocate a library 

t_free: free a library 

state (defunct) 


backup.codes1: backup 

m_fork: execute a 

dbm_clearerr, dmb_blkflush: database 
plot: graphics interface 

sulog: log of 


of a file 

du: 

repquota: 

acctems: command 
s_init_lock, s_lock, s_clock, 
sync: update the 

sync: update 

su: become 

getgroups: get 

uucp: networking 

lptypes: table of printer types 
m_park_procs, m_rele_procs: 
sleep: 

sleep: 

pause: 


records 


s_init_barrier, 
swap: 
swab: 


wait at barrier 


/a command with priority aging, PFF, 
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.string(3C) 
.strtod(3C) 


string: strcat, strdup, strncat, 
string to double-precision number 
string to integer.. 


strip: strip an... see C and Lang Tools Binder 
strlen, strchr, strrchr, strpbrk/.. 
strncat, strcmp, strncmp, strepy, strncpy,/. 
strncmp, strepy, strncpy, strlen/... 
strncpy, strlen, strchr, strrehr//.. 
strpbrk, strspn, strespn, strtok// 
strrchr, strpbrk, strspn, strespn/.. 
strspn, strespn, strtok: string/... 
strstr: find first occurrence of. 
strtod, atof: convert string to... 
strtok: string operations... 
strtol, atol, atoi: convert string.. 


...8tring(3C) 
..String(3C) 


.strstr(3C) 
strtod(3C) 
string(3C) 
....Strtol(3C) 


road |_constab(3SEQ) 
.t_alloc(3N) 


stty, gtty: set and get terminal 
stty: set the options for a terminal... 
su: become superuser or another user.. 


subcode definitions... backup. codes!(4) 


Subprogram in parallel.......sssscssssssssssesssesees m_fork(3PPS) 
subroutines ndbm(3X) 
subroutines... plot(3X) 
substitute user events sulog(4) 


sulog: log of substitute user events. 
sum: print checksum and block count... 
summarize disk usage....cssceeeees 
summarize quotas for a filesystem 
summary from per-process accounting 
s_unlock: initialize, lock, unlock locks... 
superblock... 
superblock.. 


-sum(1) 
du(1M) 


.acctems(1M) 
-s_lock(3PPS) 
syne(1M) 
sync(2) 


superuser or another user. «e8U(1M) 
supplementary group IDs... or ps(2) 
BUPPOTt fileCB......ccseceseessecsneee 

supported by the menu system 


suspend and resume child process/. 
suspend execution for an interval... 
suspend execution for interval. 
suspend process until signal.. 
swab: swap byteB.....sccssseesee 
8_wait_barrier: initialize barrier, 
swap administrative interface... 


swap: swap administrative interface.. 


swapping, or processor migration/ -noage(1M) 


DYNIX/ptx Reference Manual 


Permuted Index 
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seeks on DCC disks sweepon, 
patrol seeks on DCC disks 

symbol table/ ldgetname: retrieve 
symbol name for common object file 
]dtbindex: compute the index of a 
ldtbread: read an indexed 

syms: common object file 

ldtbseek: seek to the 

unistd: file header for 

readlink: read value of a 

symlink: make 

of common operating system terms and 
file 

table format 


controlling FMLI object vsig: 
t_syne: 

check documents for correct eqn 
(command interpreter) with C-like 


administration 


variables 
configuration file 
perror, errno, 


menu system functions 

perror, errno, sys_errlist, 
multiplexor driver st: 
Ip: 

bsearch: binary search a sorted 
constab: constructed devices 
devtab: virtual device 

ditsectb]: refresh security 

kernel auto-configuration device 
fstab: file-system- 

mnttab: mounted filesystem 
setmnt: establish mount 

shells: shell 

task: global security 

name for common object file symbol 
/compute the index of a symbol 
ldtbread: read an indexed symbol 
syms: common object file symbol 
tasktbl: create security 

get maximum in-use descriptor 
ldtbseek: seek to the symbol 

the menu system lptypes: 
getdtablesize: get descriptor 
setdtablesize: set descriptor 
classification and conversion 
hdestroy: manage hash search 
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sweepoff: enable/disable patrol .sweepon(1M) 
sweepon, sweepoff: enable/disable. .sweepon(1M) 
symbol name for common object file ..Idgetname(3X) 
symbol table entry.....scsecssrssseeseeseee .-ldgetname(3X) 
symbol table entry of a common/.. ldtbindex(3X) 
symbol table entry of a common object...........ldtbread(3X) 
symbol table format. 

symbol table of a common object file 

symbolic constants. 

symbolic link... .readlink(2SEQ) 


symbolic link to a file... .symlink(2SEQ) 
BYMDOIS...sssecsvsesesssccnsensencenscrerenseaneonsennsanenscensssesencese glossary(1) 
symlink: make symbolic link to a ee 
syms: common object file symbol... re 


syne: update superblock . 
sync: update the superbl: 
synchronize a co-process with the 
synchronize transport library ... 
syntax. 


syscall: indirect system call... 
sysconf: get configurable system.. 
sys_config: format of a system...... 
sys_errlist, sys_nerr: system error messages...... 
sysi86: machine specific functions........ 
syskeymap: identify keys to internal... 
sy8_nerr: system error messages..... 
Systech MTI-800/1600/1650 terminal 
Systech parallel line printer interface: 


.syskeymap(4) 
...perror(3C) 
.8t(7) 
ol p(7) 
.bsearch(3C) 


table entry of a common object file 
table entry of a common object file. 
table format.....sccsesseseese 
table in shared memory 
table index... eure 
table of a common object file 
table of printer types supported by, 


..tasktb](1M) 
ablemax(2SEQ) 
.ldtbseek(3X) 


..getdtablesize(2SEQ) 
mH ee 
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tabs: set 


ctags: create a 

file 

structure 

trig: sin, cos, 

sinh, cosh, 

tm: SCSI 

ts: SCSI 

hpio: Hewlett-Packard 2645A terminal 
tar: 

mtio: UNIX magnetic 

tg: SCSI 1/2-inch magnetic 

xt: Xylogics 472 MULITBUS magnetic 
mt: magnetic 


shared memory 
transport endpoint 
deroff: remove nroff, 
terminal state 
group ID 


with another transport user 
tcgetattr, 

group ID 

tsearch, tfind, 


4014: paginator for the 


init, 
directory: opendir, readdir, 
temporary file tmpnam, 


tmpfile: create a 

tmpnam, tempnam: create a name for a 
terminals 

term: format of compiled 


captoinfo: convert a 
base 

paginator for the Tektronix 4014 
special functions of the DASI 450 
ct: spawn getty to a remote 
ctermid: generate filename for 
hangup the specified controlling 
stty: set the options for a 

tabs: set tabs on a 

tty: get the name of the 

ttyname, isatty: find name of a 
/associated with a terminal or the 
termcap: 
terminfo: 


description 
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tabs on a terminal 
tabs: set tabs on a termina! 
t_accept: accept a connect request... 


tags file. 
tail: deliver the last part of a 
t_alloc: allocate a library... 


tan, asin, acos, atan, atan2: trigonometric/ 
tanh: hyperbolic functions 
tape controller... 


tape file archiver... 
tape interface. 
tape interface.. 
tape interface. 
tape manipulating program. 
tar: tape file archiver......... 
task: global security table. 
tasktbl: create security table in... 
t_bind: bind an address to a. 
tbl, and eqn constructs... 
tegetattr, tcsetattr: get/set. 
tegetpgrp: get foreground proces: 


~_.t_bind(3N) 
.deroff{1) 


..tegetpgrp(2) 


t_close: close a transport endpoint. t_close(3N) 
t_connect: establish a connection... __connect(3N) 
tesetattr: get/set terminal state ..tegetattr(2) 
tesetpgrp: set foreground process... ..tesetpgrp(2) 
tdelete, twalk: manage binary search trees......tsearch(3C) 


tee: pipe fitting... ..tee(1) 
Tektronix 4014 termina’ 
telinit: process contro] initialization... 
telldir, seekdir, rewinddir/ .. 
tempnam: create a name fora. 
temporary file 
temporary file. 
term: conventional names for.. 
term file... cosecnattsconsevsueteiay 
term: format of compiled term file . 
termcap description into a terminfc 
termcap: terminal capability data. 
terminal.. 


.tmpnam(3S) 
..tmpfile(3S) 
.tmpnam(3S) 


terminal. 450(1) 
terminal ct(1C) 
terminal ..ctermid(3S) 
terminal .fvhangup(2SEQ) 
terminal stty(1) 
terminal. tabs(1) 
terminal.......csccscscssssesssrescsssosssssssnserssceoessssarssstescoraseacaneaces tty(1) 


.ttyname(3C) 
.ttydevname(1) 
termcap(4) 
...terminfo(4) 


terminal... 
terminal associated with a device... 
terminal capability data base... 
terminal capability database... 
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streampty: STREAMS pseudo 

greek: select 

tty: controlling 

termio: general 

dial: establish an out-going 

st: Systech MTI-800/1600/1650 

xs: Xylogics 781 

tput: initialize a 

/get the device associated with a 
optimization package curses: 
gettydefs: speed and 

tegetattr, tcsetattr: get/set 

stty, gtty: set and get 

hpio: Hewlett-Packard 2645A 

line discipline getty: set 
line discipline uugetty: set 
functions of DASI 300 and 3008 
getpseudotty: get pseudo 

special functions of Hewlett-Packard 
term: conventional names for 

wait for a child process to stop or 
kill: 

exit, _exit: 

tic: 

tput: initialize a terminal or query 
convert a termcap description into a 
infocmp: compare or print out 
database 


of common operating system 


isnan: isnand, isnanf: 

ed, red: 

ex: 

edit: 

errormsg: error message 

newform: change the format of a 
fapec: format specification in 
isismgr: ISIS file manager, updates 
plock: lock process, 
tsearch, 

reporter 

login shell 


search trees 


interface 
service information 


merge: 


batch: execute commands at a later 
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terminal driver. 
terminal filter... 
terminal (gentty) interface. 
terminal interface. 
terminal line connection.. 
terminal multiplexor driver 
terminal multiplexor driver.. 
terminal or query terminfo database. 
terminal or the terminal associated/... 
terminal screen handling and... 
terminal settings used by getty. 
terminal state ....esseeee 
termina] state (defunct; 
terminal tape file archiver. 
terminal type, modes, speed, and..... 
terminal type, modes, speed, and. 


“gettydefa(4) 
..tegetattr(2) 


terminate a process -kill(1) 


terminate process.. exit(2) 
terminfo compiler.. ..tic(1M) 
terminfo database... tput(1) 
terminfo description... .captoinfo(1M) 
terminfo descriptions... infocmp(1M) 
terminfo: terminal capability. ..terminfo(4) 
termio: general terminal interface.. ..termio(7) 
terms and 8yMDbOIB ........ssssseceeeeee glossary(1) 
t_error: produce error message.. _erron(3N) 
test: condition evaluation command a test(1) 
test for floating-point NaN/ 


.isnan(3C) 


text files in ISIS file format. -isismgr(1M) 


text, or data in memory...... .-.plock(2) 
tfind, tdelete, twalk: manage binary. ..tsearch(3C) 
tfipe: interprocess communication.. .-tfipe( 1M) 
tfmenush: assign menu system as user. .tfmenush(1M) 
tfnotify: send completion message .tfnotify(1M) 
t_free: free a library structure.. ...t_free(3N) 
tg: SCSI 1/2-inch magnetic tape .....sscccscssscscesssessseeees aseet (7) 
t_getinfo: get protocol-specific.... _getinfo(3N) 
t_getstate: get the current state t_getstate(3N) 


three-way file merge... 
tic: terminfo compiler 
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view a file one full screen at a 
setting up an environment at login 


stime: set 

time: get 

time, ptime: 

and system activity timex: 
acctcon1, acctcon2: connect- 


strftime: format 
profil: execution 


mktime, tzset: convert date and 
clock: report CPU 

timezone: set default system 

times: get process and child process 
set file access and modification 
times 

update access and modification 
process data and system activity 
zone 

cooperating STREAMS module 
read/write interface STREAMS module 
request 

a transport endpoint 


processor 


temporary file 

Aisgraph, isascii, tolower, toupper, 
/tolower, _toupper, _tolower, 

conv: toupper, tolower, _toupper, 
fisascii, tolower, toupper, toascci, 
Aspunct, isprint, isgraph, isascii, 
conv: toupper, 

endpoint 

tsort: 

transport endpoint 

acctmerg: merge or add 
modification times of a file 
/tolower, toupper, toascci, _tolower, 
Asprint, isgraph, isascii, tolower, 
conv: toupper, tolower, 

_tolower, toascii: translate/_ conv: 
terminfo database 


ptrace, mptrace: process 

strace: print STREAMS 

to STREAMS error logging and event 
copy: perform a standalone data 
init.d: system level 

_toupper, _tolower, toascii: 
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time a command. 
time a command; report process data 


time accounting... .acctcon(1M) 


time: get time...csesecocssssseceseseessererenesrenenseceeesenesorneneees time(2) 
time information strftime(3C) 
time profile....... .profil(2) 
time, ptime: time a command. ..time(1) 
time to string .ctime(3C) 
time used... .clock(3C) 
time zone. .timezone(4) 
times. ....times(2) 
times utime(2) 


times: get process and child process, 
times of a file... 


timex: time a command; report. timex(1) 
timezone: set default system time. .timezone(4) 
timod: Transport Interface... .-timod(7) 


..tirdwr(7) 
.t_listen(3N) 


tirdwr: Transport Interface 
t_listen: listen for a connect... 
t_look: look at the current event on. 
tm: SCSI tape controller... 
tmp_affinity: bind a process to 
tmp_ctl: multi-processor control 
tmpfile: create a temporary file.... 
tmpnam, tempnam: create a name for a 
toascci, _tolower, _toupper/.... 
toascii: translate characters.. 
_tolower, toascii: translate/.. 
_tolower, _toupper, setchrclass: 
tolower, toupper, toascci, _tolower, 
tolower, _toupper, _tolower, toasc’ 
t_open: establish a transport. 
topological S0rt........sscsssssessseees 
t_optmgmt: manage options for a. 
total accounting files...... 
touch: update access and. 
_toupper, setchrclass: character/ 
toupper, toascci, _tolower/........ 
_toupper, _tolower, toascii: translate/. 
toupper, tolower, _toupper, 
tput: initialize a terminal or query... 
tr: translate characters. 
trace facility... 
trace messages 


.tmp_affinity(2SEQ) 
mp_ctl(2SEQ) 
..tmpfile(3S) 


__optmgmt(3N) 
.acctmerg( 1M) 


.-ptrace(2) 


tracing... -log(7) 
transfer... copy(8) 
transition files directory.. it. 


translate characterz...... 
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tr: 

t_bind: bind an address to a 

t_close: close a 

look at the current event on a 
t_open: establish a 

t_optmgmt: manage options for a 
t_unbind: disable a 

STREAMS module timod: 
interface STREAMS module _ tirdwr: 
t_sync: synchronize 

the scheduler for the uucp file 
uucico: file 

establish a connection with another 
data sent over a connection 
confirmation from a connect request 
disconnect 

orderly release indication 


error indication 

ftw: walk a file 

tdelete, twalk: manage binary search 
atan, atan2: trigonometric/ 

cos, tan, asin, acos, atan, atan2: 


truncate, ftruncate: 

to a specified length 

u3b2, u3b5, vax: get processor type 
true, false: provide 


manage binary search trees 
over a connection 
disconnect request 

release 


library 
interface 
streamtty: Generic STREAMS 


1d0: STREAMS 

between major/minor numbers and 
associated with a terminal or the/ 
terminal 
dev_to_ttyname, 

file of the current user 
endpoint 

vmtune: 

tunefs: 

filesystem 

examine and change virtual memory 
/prdaily, prtacct, shutacct, startup, 
tsearch, tfind, tdelete, 


major/minor/ 


parameters 
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translate characters 
transport endpoint... 


transport endpoint... 
Transport Interface cooperating... 
Transport Interface read/write 
transport library.. 


_-unbind(3N) 
...timod(7) 
.tirdwr(7) 


transport program for the uucp system. 


TLANSPOTt UBET.....sccsceossssscserscsseeorer ot, “connect(3N) 


t_rev: receive data or expedited .t_rev(3N) 
t_reveonnect: receive the... "reveonnect(3N) 
t_revdis: retrieve information from t_revdis(3N) 
t_revre]: acknowledge receipt of an. t_revrel(3N) 
t_rcvudata: receive a data unit... revudata(3N) 
t_revuderr: receive a unit data.. __revuderr(3N) 


trig: sin, cos, tan, asin, acos,.. 
trigonometric functions... 


true, false: provide truth values... soeeeetrue(1) 
truncate a file to a specified length.. .truncate(2SEQ) 
truncate, ftruncate: truncate a file... aeeerr 


truth value. 


tsearch, tfind, tdelete, twalk: 
t_snd: send data or expedited data... 
t_snddis: send user-initiated. 
t_sndrel: initiate an orderly... 
t_sndudata: send a data unit 
tsort: topological sort ......006. 
t_sync: synchronize transport... 
tty: controlling terminal (gentty).. 
tty driver interface........ sciemterant 
tty: get the name of the terminal. 
tty line discipline. 
tty DAMES........0000. 
ttydevname: get the device 
ttyname, isatty: find name of a 
ttyname_to_dev: convert between 
ttyslot: find the slot in the utmp. 
t_unbind: disable a transport... 
tune system-wide virtual-memory 
tune up an existing filesystem... 
tunefs: tune up an existing 
tuning parameters......ssessees 
turnacct: shell procedures for) 
twalk: manage binary search trees...... 


.dev_| to,  ttyname(3C) 
..ttyslot(3C) 
_unbind(3N) 
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types: primitive system data 
Iptypes: table of printer 

/asctime, cftime, ascftime, mktime, 
machid: i386, ns32000, pdp11, 
machid: i386, ns32000, pdp11, u3b, 
A386, ns32000, pdp11, u3b, u3b2, 
/endspent, fgetspent, Ickpwdf, 
mask 


mount, 


mountall, 
system 


filesystems 


expand data compress, 
unget: 

SCCS file 

input stream 

file 

mktemp; make a 
constants 
t_revudata: receive a data 
t_sndudata: send a data 
t_revuderr: receive a 


mtio: 

cu: call another 

link, unlink: link and 
link, 


m_lock, m_unlock: lock, 

s_clock, s_unlock: initialize, lock, 
space munmap: 
spellhist: 

umount: 

mount, umount: mount and 
mountall, umountall: mount, 

pack, peat, 

set, unset: set and 

variables in core or in files set, 
lsearch, Ifind: linear search and 
touch: 

make: maintain, 

bdflush: 

bdflush: 

syne: 

sync: 


from/ pweonv: installs and 
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.types(5) 
.types(5) 
.lptypes(4) 
ctime(3C) 
-machid(1) 
-machid(1) 
-machid(1) 
.uadmin(1M) 
-uadmin(2) 


types: primitive system data types.. 
types supported by the menu system.. 
tzset: convert date and time to/........... 
u3b, u3b2, u3b6, vax: get processor type/.. 
u3b2, u3b5, vax: get processor type/.... 
u3b5, vax: get processor type truth/. 
uadmin: administrative control... 
uadmin: administrative control... 
ulckpwdf: get shadow password file entry 
ulimit: get and set user limits 
umask: set and get file creation... 
umask: set file-creation mode mask 
umount: mount and unmount filesystems. 
umount: unmount a filesystem........... 
umountall: mount, unmount multiple. 
uname: get name of current operating 
uname: print name of current system 
uncompress, zcat: compress and 
undo a previous get of an SCCS file. 
unget: undo a previous get of an... 
ungetc: push character back into. 
uniq: report repeated lines in a. 
unique filename ....cccsssssseseeees 

unistd: file header for symbolic. 
UNIt ..seseseereees 


.mountall(1M) 
.uname(2) 
..uname(1) 


unit data error indication. 
units: conversion program.. 
UNIX magnetic tape interface 
UNIX BYStOM uo esscecesseseccerssenee 
unlink files and directories. 
unlink: link and unlink files and directories. 
unlink: remove directory entry.. 
unlock locks. 
unlock locks. 
unmap part of the processs address 
unmatched spelling words file 
unmount a filesystem... 
unmount filesystems..... 
unmount multiple filesystems. 
unpack: compress and expand files... 
unset environment variables in core or in files... 
unset: set and unset environment 
UPCAte...cscssssessssesecseresreenaree 
update access and modification times of a file. 
update, and regenerate groups of programs 
update daemon... aes 
update daemon... 
update superblock... 
update the superblock... 
updates /etc/shadow with information... 


‘m_lock(3PPS) 
...8_lock(8PPS) 


..._pweonv( 1M) 
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isismgr: ISIS file manager, 

been up 

du: summarize disk 

quota: display disk 

retrieve a command description and 
description and usage examples 


getusclk, 

get character login name of the 
logname: return login name of 
setup: initialize system for first 

su: become superuser or another 

a connection with another transport 
slot in the utmp file of the current 
write: write to another 

cpset: copy file and set mode, 
setuid, setgid: set 

id: print 

crontab: 

addusr.def: add 

/geteuid, getgid, getegid: get real 
environ: 

run commands performed for multi- 
sulog: log of substitute 

generate disk accounting data by 
ulimit: get and set 

tfmenush: assign menu system as 
menumsg: route 

edquota: edit 

/getegid: get real user, effective 
t_snddis: send 

editor (variant of ex for casual 

the operating system for beginning 
wall: write to all 

ut_delete_user: add/delete 

mail, rmail: send mail to 


login attempts 
add/delete users in utmp file 
utmp file ut_add_user, 


introduction to system standalone 
get_process_stats: get resource 
modification times 

utmp, wtmp: 

ut_delete_user: add/delete users in 
endutent, utmpname, getutpid: access 
ttyslot: find the slot in the 

formats 

/pututline, setutent, endutent, 

and permissions file 

the uucp system 

clean-up 
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updates text files in ISIS file format... 
uptime: show how long system has. 
UBEZE cosessssseseees 
usage and limits. 
usage examples.. 
usage: retrieve a command. 
usclk: 32-bit microsecond counter. 
usclk_init: get/init microsecond clock 
user... 

user 
user 
user 
user 
user.. 
user... 

user, and group IDs. 
user and group IDs.... 
user and group IDs and names. 
user crontab file.... 
user defaults...... 
user, effective user, real group/.. 
user environment.........4 ene 
user environment.. 
user events... 


user login shell.. ..tfmenush(1M) 


user message to menu message queve..........menumsg( 1M) 
UBET QUOTAS. ..ceecesssreeseenes sdnasbusesenteessottsa .edquota(1M) 
user, real group, and effective/......0 -getuid(2) 


user-initiated disconnect request .t_snddis(3N) 


users. 
users in utmp file. 
users or read mail. 
Ausr/adny/loginlog: log of failed/... 
ustat: get filesystem statistics. 
ut_add_user, ut_delete_user:.. 
ut_delete_user: add/delete users in 
utilities: 
utilization information.... 


..utadduser(3X) 
tadduser(3X) 
intro(8) 
..get_process_stats(2SEQ) 


utime: set file access AN ....ssssssssssssseenseneseeseestseeneeees utime(2) 
utmp and wtmp entry formats...c...scssessssseeeeserseeneee utmp(4) 
utmp file......... utadduser(3X) 
utmp file entry. a... getut(3C) 
utmp file of the current user... ~ ttyslot(3C) 


utmp, wtmp: utmp and wtmp entry. 
utmpname, getutpid: access utmp file/. 
uucheck: check the uucp directories... 
uucico: file transport program for.. 
uucleanup: uucp spoo! directory... 


..utmp(4) 
getut(3C) 
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uucheck: check the 
uusched: the scheduler for the 


uucleanup: 

uustat: 

file transport program for the 
UNIX-to-UNIX system/ 
speed, and line discipline 
uucp, 

uucp, uulog, 

uuto, 

file transport program 
control 

UNIX-to-UNIX system/ 

with debugging on 

system command execution 
requests 


val: 


abs: return integer absolute 

u3bb, vax: get processor type truth 
getenv: return 

floor, ceiling, remainder, absolute 
readlink: read 

putenv: change or add 

current form field to its default 
true, false: provide truth 

values: machine-dependent 


print formatted output of a 

list 

varargs: handle 

fpathconf: get configurable pathname 
sysconf: get configurable system 
.environ, .pref, 

unset: set and unset environment 
edit: text editor ( 

proc_ctl: control over 

/ns32000, pdp11, u3b, u3b2, u3b5, 


get option letter from argument 
readv: read 

writev: write 

assert: 

ve: 

get: geta 

sccsdiff: compare two 

virtual memory efficient way 
output of a vararge/ vprintf, 
editor based on ex 

more: 
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uucp directories and permissions file. ...uucheck(1M) 


uucp file transport program.. .uusched(1M) 
uucp: networking support files......sssecssecssssecseeseeseessee uucp(4) 
uucp spool directory clean-up..... uucleanup(1M) 
uucp status inquiry and job contro’ uustat(1C) 
DWUCP BYBtEM «...sseeeeee uucico(1M) 
uucp, uulog, uuname: ..uucp(1C) 
uugetty: set terminal type, modes,. “augetty(1M) 
uulog, uuname: UNIX-to-UNTX/... ..uucp(1C) 


uuname: UNIX-to-UNIX system copy... 
uupick: public UNIX-to-UNIX/, 
uusched: the scheduler for the uucp... 
uustat: uucp status inquiry and job 
uuto, uupick: public.......csssecssecseenes 
Uutry: try to contact remote system... 


UWUX: UNTX-t0-UNTX.ssecscsesssssersererees uux(1C) 
uuxqt: execute remote command. uuxgt(1M) 
val: validate SCCS file -val(1) 


validate SCCS file........ -val(1) 
valloc: aligned memory allocator. valloc(3SEQ) 
VENUE ..sssecsssvssessesessesssenssescessseeneseenesnsseceeeateneeeestestereneees abs(3C) 


.»machid(1) 
value for environment name 
value functions..... 
value of a symbolic link. 
value to environment. 
values... 
values.. 
values.. 
values: machine-dependent values 
varargs argument list........ sdbsasaaiceaee 


varargs: handle variable argument... .varargs(5) 
variable argument list -varargs(5) 
variables... pathconf(2) 
variables... syscon{(2) 


-variables: FACE files.. 
variables in core or in files... 
variant of ex for casual users). 
various process attributes........ 
vax: get processor type truth value 
ve; version control... 
...getopt(3C) 
readv(2SEQ) 
writev(2SEQ) 
.assert(3X) 


vector from file . 
vector on a file.. 
verify program assertion .. 
version control... 
version of an SCCS file. 
versions of an SCCS file.. 
vfork: spawn new process in a.. 
viprintf, vsprintf: print formatted.. 
vi: screen-oriented (visual) display. 


view a file one full screen at a time... “more(1) 
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map physical addresses into processs 
devtab: 

devdestroy: build and destroy 

vfork: spawn new process in a 
vm_ctl: examine and change 

echo: put string on 

controlling terminal fvhangup: 
vmtune: tune system-wide 

pmap: display or alter parameters of 
vi: screen-oriented 

memory tuning parameters 
virtual-memory parameters 
filesystem 

fs, inode: format of file system 
formatted output of a varargs/ 

the controlling FMLI object 

a varargs/ vprintf, vfprintf, 
prtvtoc: print the 

prtvtoc: print the 

mkvtoc: populate 

vtoc: 


s_wait_barrier: initialize barrier, 


wait, waitpid: 

sigsuspend: 

process to stop or terminate 

stop or terminate wait, 
ftw: 


whodo: 
who: 


vmtune: tune system- 
addformopt: add a form/SELECT 
we: 

fgetc, getw: get character or 
fputc, putw: put character or 
spellhist: unmatched spelling 

ced: change 

chdir: change 

getcwd: get pathname of current 
pwd: 

specific alarms and/or the 
interface 

lseek: move read/ 

tirdwr: Transport Interface read/ 
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virtual device table. 
virtual devices. 
virtual memory efficient way 
virtual memory tuning parameters 


‘Virtual Output ssscicasassasscessssncseasscateasacavesscenetoseusssvieesstes echo(1F) 
virtually hangup the specified. .fvhangup(2SEQ) 
virtual-memory parameters.... .vmtune(1M) 
virtual-to-physical mapping devices. .pmap(1M) 
visual display editor based OM €X.....sssssceseseroeeeserseeseee vi(1) 


vm_ctl: examine and change virtual... 
vmtune: tune system-wide... 
volcopy: make literal copy of. 


..vm_ctl(2SEQ) 
..». v@ntune(1M) 


.volcopy(1M) 


VO]UME.....ccsccscessessscescersesvoonsenscacoconsonsasensensaseavonsrsreseanenssseee fs(4) 
vprintf, vfprintf, vaprintf: print... vprintf(3S) 
vsig: synchronize a co-process with vsig(1F) 
vsprintf: print formatted output of. vprint{(3S) 
VTOC of a block device......sssseccee prtvtoc( 1M) 


VTOC of a standalone disk device 
VTOC on disks... 
VTOC partitioning drive 
vtoc: VTOC partitioning driver 
wait at barrier.......... Scanseweenieay 
wait: await completion of process... 
wait for a child process to stop or termina’ 
wait for a signal 
wait, waitpid: wait for a child... 
waitpid: wait for a child process to 
walk a file tree... 
wall: write to all users. 
WC: WOFd COUNL. essere 
wd: SSM SCSI disk controller... 
what: identify SCCS files.. 
whatis: describe what a command is 
who is doing what....... 
who is on the system.. 
who: who is on the system... 
whodo: who is doing what... 
wide virtual-memory parameters.. 
window option to a menu... 
word count... 
word from a stream. 
word on a stream 


working directory. 
working directory 
working directory... 
working directory name. 
working indicator... 
wp: SSM parallel line prin 
write file pointer........ssssssssee 
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write: 
putpwent: 
putspent: 
wall: 
write: 
writev: 


open: open for reading or 
utmp, wtmp: utmp and 
utmp, 

accounting records fwtmp, 
and execute command 
multiplexor driver 

tape interface 

xt: 

xs: 

bessel: jO, j1, jn, 

bessel: j0, j1, jn, y0, 


compress, uncompress, 


for dual-channel disk controller 
getzdinfo, getzdinfobyname: get 
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Wite OD & file .....sssesscsssssessesessnsscrecneesssssnesnceneneseseresees write(2) 
write password file entry.......... ..putpwent(3C) 
write shadow password file entry. putspent(3X) 
write to all users...... ..wall(1) 
write to another user. -write(1) 
write vector on a file. .-writev(2SEQ) 
write: write on a file..... ..write(2) 
write: write to another user.. »Wwrite(1) 
writev: write vector on a file.. ..writev(2SEQ) 
..open(2) 
-utmp(4) 


wtmp entry formats... 
wtmp: utmp and wtmp entry formats 


wtmpfix: manipulate connect....... wtmp(1M) 
xargs: construct argument list(s). .xargs(1) 
xs: Xylogics 781 terminal...........00+ +X8(7) 


xt: Xylogics 472 MULITBUS magnetic 
Xylogics 472 MULITBUS magnetic tape interface... 
Xylogics 781 terminal multiplexor driver. 
y0, yl, yn: Bessel functions 
yl, yn: Bessel functions...... 
yace: yet another compiler-compile 
zcat: compress and expand data... 
zd: dual-channel disk controller... 
zdformat: standalone disk formatter.. 
Zinfo StrUCtUFE.....0e0see er eaeensaue 


.compress(1) 
+20(7) 
dformat(8) 
-getzdinfo(3SEQ) 
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(4) File Formats 
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DYNIX/ptx INTRO(4) 


NAME 
@ intro — introduction to file formats 


DESCRIPTION 
This section outlines the formats of various files. The C structure declarations 
for the file formats are given where applicable. 
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NAME 


a.out — common assembler and link editor output 


SYNOPSIS 


#include <a.out.h> 


DESCRIPTION 


12/89 


The file name a.out is the default output file name from the link editor Id(1). 
The link editor makes a.out executable if there were no errors in linking. The 
output file of the assembler as(1), also follows the common object file format of 
the a.out file although the default file name is different. 


Acommon object file consists of a file header, a system header (if the file is 
link editor output), a table of section headers, section data, relocation informa- 
tion, (optional) line numbers, a symbol table, and a string table. The order is 
given below. 


File header. 
system header. 
Section 1 header. 


Section n header. 
Section 1 data. 


Section n data. 
Section 1 relocation. 


Section n relocation. 
Section 1 line numbers. 


Section n line numbers. 
Symbol table. 
String table. 


The last three parts of an object file (line numbers, symbol table and string 
table) may be missing if the program was linked with the -s option of Id(1) or 
if they were removed by strip(1). Also note that the relocation information is 
absent after linking unless the -r option of ld(1) was used. The string table 
exists only if the symbol table contains symbols with names longer than eight 
characters. 

The sizes of each section (contained in the header, discussed below) are in 
bytes. 

When an a.out file is loaded into memory for execution, three logical seg- 
ments are set up: the text segment, the data segment (initialized data followed 
by uninitialized, the latter actually being initialized to all 0’s), and a stack. 
On Sequent systems the text segment starts at location 0x0. 


The a.out file produced by 1d(1) has the magic number 0524 in the first field of 
the system header. The headers (file header, system header, and section 
headers) are loaded at the beginning of the text segment and the text immedi- 
ately follows the headers in the user address space. The first text address 
equals 0x0 plus the size of the headers, and varies depending upon the 
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number of section headers in the a.out file. In an a.out file with four sections 
(.text, .data, .bss, and .comment), the first text address is at Oxd0 on Sequent 
systems. The comment section is not loaded in memory and is not part of the 
process image. The text segment is not writable by the program; if other 
processes are executing the same a.out file, the processes share a single text 
segment. If the -Z option is specified with Id, the text starts at hexadecimal 
0x1000. 


The data segment starts at the next page boundary past the last text address. 
The first data address is determined by the following: If an a.out file were 
split into 4K blocks, one of the blocks would contain both the end of text and 
the beginning of data. When the core image is created, that block appears 
twice; once at the end of text and once at the beginning of data. The dupli- 
cated block of text that appears at the beginning of data is never executed; it 
is duplicated so that the operating system may bring in pieces of the file in 
multiples of the page size without having to realign the beginning of the data 
section to a page boundary. Therefore the first data address is the sum of the 
next segment boundary past the end of text plus the remainder of the last text 
address divided by 4K. If the last text address is a multiple of 4K, text infor- 
mation is not duplicated. 


On Sequent systems the stack begins at location 0x40000000 and grows toward 
lower addresses. The stack is automatically extended as required. The data 
segment is extended only as requested by the brk(2) system call. 


For relocatable files, the value of a word in the text or data portions that is not 
a reference to an undefined external symbol is exactly the value that appears 
in memory when the file is executed. Ifa word in the text involves a reference 
to an undefined external symbol, there is a relocation entry for the word, the 
storage class of the symbol-table entry for the symbol is marked as an “exter- 
nal symbol”, and the value and section number of the symbol-table entry are 
undefined. When the file is processed by the link editor and the external sym- 
bol becomes defined, the value of the symbol is be added to the word in the file. 


File Header 
The format of the filehdr header is as follows: 


struct filehdr 

{ 
unsigned short f_magic; /* magic number Ly i 
unsigned short f_nscns; /* number of sections */ 


long f_timdat; /* time and date stamp */ 
long £_symptr; /* file ptr to symtab */ 
long f_nsyms; /* # symtab entries */ 


unsigned short f_opthdr; /* sizeof(opt hdr) */ 
unsigned short f_flags; /* flags */ 
3 
System Header 
The format of the system header is as follows: 


typedef struct aouthdr 


{ 
short magic; /* magic number */ 
short vstamp; /* version stamp */ 
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long tsize; /* text size in bytes, padded */ 

long dsize; /* initialized data (.data) */ 

long bsize; /* uninitialized data (.bss) */ 

long entry; /* entry point */ 

long text_start; /* base of text used for this file */ 

long data_start; /* base of data used for this file */ 
} AOUTHDR; 


Section Header 
The format of the section header is as follows: 


struct scnhdr 


{ 


char s_name[SYMNMLEN); /* section name */ 
long s_paddr; /* physical address */ 

long s_vaddr; /* virtual address */ 

long s_size; /* section size */ 

long s_scnptr; /* file ptr to raw data */ 
long s_relptr; /* file ptr to relocation */ 


long s_lnnoptr; /* file ptr to line numbers */ 
unsigned short s_nreloc; /* # reloc entries */ 
unsigned short s_nlnno; /* # line number entries */ 
long s_flags; /* flags */ 
Me 
Relocation 
Object files have one relocation entry for each relocatable reference in the text 
or data. If relocation information is present, it is in the following format: 


struct reloc 
{ 
long r_vaddr; /* (virtual) address of reference */ 
long r_symndx;/* index into symbol table */ 
ushort xr_type; /* relocation type */ 
Me 
The start of the relocation information is s_relptr from the section header. If 
there is no relocation information, s_relptr is 0. 


Symbol Table 
The format of each symbol in the symbol table is as follows: 
#define SYMNMLEN 8 
#define FILNMLEN 14 
#define DIMNUM 4 


struct syment 


{ 


union /* all ways to get a symbol name */ 
{ ; 
char _n_name(SYMNMLEN]; /* name of symbol */ 
struct 
{ 
long _n_zeros; 


/* == OL if in string table */ 
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long _n_offset; 
/* location in string table */ 
} _n_n; 
char * n_nptr[2]; 
/* allows overlaying */ 
} _n; 
long n_value; 
/* value of symbol */ 
short n_scnum; 
/* section number */ 
unsigned short n_type; 
/* type and derived type */ 
char n_sclass; 
/* storage class */ 
char n_numaux; 


/* number of aux entries */ 


; 


#define n_name _n._n_name 

#define n_zeros n._nn._n_ zeros 

#define n_offset _n._n_n._n_offset 
#define n_nptr _n._n_nptr[1] 


Some symbols require more information than a single entry; they are followed 
by auxiliary entries that are the same size as a symbol entry. The format is as 


follows: 


union auxent { 
struct { 
long x_tagndx; 
union { 
struct { 
unsigned shortx_lnno; 
unsigned shortx_size; 
} x_lnsz; 
long x_fsize; 
} x_misc; 
union { 
struct { 
long x_lnnoptr; 
long x_endndx; 
} x_fen; 
struct { 
unsigned shortx_dimen [DIMNUM) ; 
} x_ary; 
} x_fenary; 
unsigned short x_tvndx; 
} x_sym; 


struct { 


char x_fname[FILNMLEN] ; 
} x_file; 
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struct { 
long x_scnlen; 
unsigned short x_nreloc; 
unsigned short x_nlinno; 


} x_scn; 

struct { 
long x_tvfill; 
unsigned short x_tvlen; 
unsigned short x_tvran[2]; 

} x_tv; 


ye 

Indexes of symbol table entries begin at zero. The start of the symbol table is 

f_symptr (from the file header) bytes from the beginning of the file. If the 

symbol table is stripped, f_symptr is 0. The string table (if one exists) begins 

at f symptr + (f_nsyms * SYMESZ) bytes from the beginning of the file. 
SEE ALSO 

as(1), cc(1), 1d(1), brk(2), filehdr(4), ldfen(4), linenum(4), reloc(4), senhdr(4), 

syms(4) 
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NAME 


ACCT(4) 


acct — per-process accounting file format 


SYNOPSIS 


#include <sys/acct.h> 


DESCRIPTION 


Files produced as a result of calling acct(2) have records in the form defined 


by <sys/acct.h>, whose contents are: 
typedef ushort comp_t; 


/* "floating-point" */ 


/* 13-bit fraction, 3-bit exponent */ 


struct acct 


char 
char 
uid_t 
gid_t 
dev_t 
time_t 
comp_t 
comp_t 
comp_t 
comp_t 
comp_t 
comp_t 
char 
Ve 


extern struct 
extern struct 


#define AFORK 
#define ASU 
#define ACCTF 


ac_flag; 
ac_stat; 
ac_uid; 
ac_gid; 
ac_tty; 
ac_btime; 
ac_utime; 
ac_stime; 
ac_etime; 
ac_mem; 
ac_io; 
ac_rw; 
ac_comm[8]; 


acct 
inode 


01 
02 
0300 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


Accounting flag */ 

Exit status */ 

Accounting user ID */ 

Accounting group ID */ 

control typewriter */ 

Beginning time */ 

acctng user time in clock ticks */ 
acctng system time in clock ticks */ 
acctng elapsed time in clock ticks */ 
memory usage in clicks */ 

chars trnsfrd by read/write */ 
number of block reads/writes */ 
command name */ 


acctbuf; 
*acctp; /* inode of accounting file */ 


/* 
/* 


» &F 


has executed fork, but no exec */ 
used superuser privileges */ 
record type: 00 = acct */ 


In ac_flag, the AFORK flag is turned on by each fork(2) and turned off by an 
exec(2). The ac_comm field is inherited from the parent process and is reset 


by any exec. 


The ac_mem field is not maintained by the system and is always reported as 


0. 


The structure tacct, which resides with the source files of the accounting com- 
mands, represents the total accounting format used by the various accounting 


commands: 


* 


* total accounting (for acct period), also for day 


*/ 
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struct tacct { 
uid_t 
char 
float 
float 
float 
float 
long 


ta_uid; 
ta_name[8]; 
ta_cpu[2]; 
ta_kcore[2]; 
ta_con[2]; 
ta_du; 
ta_pc; 


unsigned short ta_sc; 
unsigned short ta_dc; 
unsigned short ta_fee; 


VG 
SEE ALSO 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
[* 
/* 
/* 
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userid */ 

login name */ 

cum. cpu time, p/np (mins) */ 
cum kcore-minutes, p/np */ 

cum. connect time, p/np, mins */ 
cum. disk usage */ 

count of processes */ 

count of login sessions */ 
count of disk samples */ 

fee for special services */ 


acct(2), exec(2), fork(2), acct(1M), acctcom(1) 
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NAME 
& addusr.def — add user defaults 
DESCRIPTION 

The Add User Defaults file contains the defaults displayed on the Add User 

Form. 

Each record is in the following format: 

name=value 

The following default values can be defined: 

PASSWD_AGE_MAX 
This record contains the default value for the maximum 
number of days a password can be in effect. 

PASSWD_AGE_MIN 
This record contains the default value for the minimum 
number of days a password can be in effect. 

USERACCT This record contains the name of the parent directory 
where user accounts will be created if'a directory is not 
specified by the System Administrator. 

USERGROUP This record contains the name of the default group for a 
new user. This value is displayed in the group field in 
the addusr form. 


USERSHELL This record contains the name of the default shell or 
program for a new user. This value is displayed in the 
shell field in the addusr form. 

USERMENU This record contains the name of the initial menu the 


user will enter when he logs onto the system. This only 
applies to users who have the menu system as their ini- 
tial login program. This value is displayed in the initial 
menu field in the addusr form. 
FIELDS 
Name 
This is the name of the value to be set. See the above description section for 
the supported values. This is a required field. 
Value 
This is the default value to be displayed. See the above description section for 
more information. This is a required field. 


FILES 
$(TFADMFILE}/etc/addusr.def Add User Defaults 


NOTES 
To change the contents of this file, use the addusrdef command. 
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NAME 


pathalias — alias file for FACE 


DESCRIPTION 


NOTES 


FILES 


The pathalias files contain lines of the form "alias=path" where path is one or 
more colon (:) separated directories. Whenever a FACE user references a path 
not beginning with a slash (/), this file is checked. If the first component of the 
pathname matches the left side of the equals sign, the right side is searched 
much like the $PATH variable in the operating system. This allows users to 
reference the folder $HOME/FILECABINET by typing filecabinet. 


There is a system-wide pathalias file called $VMSYS/pathalias, and each user 
can also have local alias file called $HOME/pref/pathalias. Settings in the 
user alias file override settings in the system-wide file. The system-wide file is 
shipped with several standard FACE aliases, such as filecabinet, wastebasket, 
preferences, other_users, etc. 


Unlike command keywords, partial matching of a path alias is not permitted, 
however, path aliases are case insensitive. The name of an alias should be 
alphabetic, and in no case can it contain special characters like "/'," or "=". 
There is no limit on the number of aliases allowed. Alias files are read once, 
at login, and are held in core until logout. Thus, if an alias file is modified dur- 


ing a session, the change does not take effect until the next session. 


$HOME/pref/pathalias 
$VMSYS/pathalias 


SEE ALSO 


12/89 


env(4) 


DYNIX/ptx BACKUP_CODES(4) 


NAME 
backup.codes — backup cycle code definitions 


DESCRIPTION 
The backup cycle codes file lists the types of backup cycles available for sched- 
uled backups. 


FIELDS 
Backup Cycle 
Type of backup cycle. This field is the key to the record. This is a required 
field. 


Backup Cycle Description 
This is the long description of the cycle displayed in SELECT windows. This is 
a required field. 

Backup Cycle Code 


This code describes the length of the backup cycle to the menu system, which 
supports the following codes: 


W Weekly Backup Cycle 
M Monthly Backup Cycle 
Y Yearly Backup Cycle 


This is a required field. 


Retention Multiplier 
Not currently used. This is an optional field. 


Is epoch date based on fiscal 
Not currently used. This is an optional field. 


Epoch Date 
Start date of the period. This is a required field. 
FILES 
${TFADMFILE)/etc/backup.codes Backup Cycle Code Definitions 
$(TFADMFILE}/etc/backup.codes1 Backup Subcodes Description File 
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NAME 
backup.codes1 — backup subcode definitions 


DESCRIPTION 
The backup subcodes file contains the components of each backup cycle 
defined on the system. 


FIELDS 


Backup Cycle 
Type of backup cycle. One or more records in this file can be related to the cor- 
responding cycle definition in the backup.codes file. This is a required field. 


Backup Cycle Description 
This a description of the cycle displayed in SELECT windows. This isa 


required field. 

Backup Cycle Subcode 
This is a code that describes the subinterval of the backup cycle period. For a 
weekly cycle, the subcodes are abbreviations for the days of the week. For a 
monthly cycle, the subcodes are the days of the month (that is, 1 through 31). 
For a yearly cycle, the subcodes are the months of the year. This is a required 
field. 

Subcode Description 
This is a description of the subcode displayed to the user. The subcode is used 
internally only. This is a required field. 

Day within cycle 
This is the day when the subinterval of the cycle occurs. This is a required 


field. 

FILES 
${TFADMFILE)/etc/backup.codes1 Backup Subcode Definitions 
${TFADMFILE)/etc/backup.codes Backup Cycle Code Definitions 
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NAME 
backup.dev — backup devices 


DESCRIPTION 
The commands on the Backup and Restore Menu use this file. The file is 
maintained by the forms on the Backup Device Information Menu, a submenu 
of the Backup and Restore Menu. 


FIELDS 
Raw Device 
This is the name of the raw device for the backup device. This is a required 
field. 


Block Device 
This is the name of the raw device for the backup device. This is a required 
field. 


Mountable Device? 
This is a boolean code that tells you if the device can be mounted by the 
backup system. The menu system supports the following codes: 


Y Yes 
N No 
This is a required field. 


Number of Blocks 
Capacity of the media in disk blocks. Block size is 512 bytes. The value in this 
field controls the size of the file system that can be built on the device. This is 
an optional field. 


Number of Inodes 
This is the number of inodes that are allocated when a file system is built. 
This is an optional field. 

Description 
Description of the backup device. The value in this field is displayed in the 
SELECT windows that display backup devices. The text should be easy to 
understand. This is a required field. 


Input Preprocessor Program 
This program preprocesses the input and pipes it to the cpio -i program. The 
cpio -i then reads the information. This is an optional field. 


Output Postprocessor Program 
This program postprocesses the output of the cpio -o program and writes 
directly to the output device. This is an optional field. 


Tape Rewinder Program 
This option is for sequential devices that support a rewinding function (for 
example, tape drives). It is not applicable to random access devices such as 
hard disks. This is a optional field. 


Media Format Command 
This option is for devices that must be formatted before use. Enter the com- 
mand and the options required to format the device. This is a optional field. 


Tape Retension Program : 
This option is for sequential devices that support a retensioning function (for 
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example, tape drives). This option does not apply to random access devices 
such as hard disks. This is a optional field. @ 


Media Erase Command 
This option is for devices that support an erase function. This is a optional 
field. 


PILES 
$(TFADMFILE)/etc/backup.dev Backup Devices 
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NAME 
backup.info — backup set definitions 


DESCRIPTION 
The Backup Set Definitions file lists the backup operations defined by users in 
the Scheduled Backup Management menu. 
FIELDS 
Backup Set Name 
This name identifies the backup set. This is a required field. 
Backup Set Description 
This field is displayed in the SELECT windows and helps the user identify the 
backup set. This is a required field. 
Directories to be backed up 
This code describes the length of the backup cycle. The system supports the 
following codes: 


W Weekly Backup Cycle 
M Monthly Backup Cycle 
Y Yearly Backup Cycle 


This is a required field. 


Retention Multiplier 
Not currently used. This is an optional field. 


Is epoch date based on fiscal 
Not currently used. This is an optional field. 


Epoch Date 
Start date of the period. This is a required field. 
FILES 
${TFADMFILE)/etc/backup.info Backup Set Definitions 
$(TFADMFILE)/etc/backup.codes1 Backup Subcodes Description File 
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NAME 


cftime — language specific strings 


@ DESCRIPTION 


The programmer can create one printable file per language. These files must 
be kept in a special directory, /lib/cftime. If this directory does not exist, the 
programmer should create it. The contents of these files are: 


¢ abbreviated month names ( in order ) 

¢ month names ( in order ) 

¢ abbreviated weekday names ( in order ) 
¢ weekday names ( in order ) 


¢ default strings that specify formats for local time (%x) and 
local date (%X). 


¢ default format for cftime, if the argument for cftime is 
zero or null. 


¢ AM (ante meridian) string 
¢ PM (post meridian) string 


Each string is on a line by itself. All white space is significant. The order of 
the strings in the above list is the same order in which the strings appear in 
the file shown below. 


EXAMPLE 


FILES 


/lib/cftime/usa_english 


Jan 
Feb 


January 
February 
Sun 

Mon 
Sunday 
Monday 


%H:%M:%S 
sm/%d/ty 

sa tb $d ST EZ BY 
AM 

PM 


Nib/cftime — directory that contains the language specific printable files (cre- 
ate it ifit does not exist) 


SEE ALSO 
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NAME 
checklist — list of filesystems processed by fsck and ncheck 


DESCRIPTION 
checklist resides in directory /etc and contains a list of special filenames. 
Each special filename is contained on a separate line and corresponds to a 
filesystem. Each filesystem is then automatically processed by the fsck(1M) 
command if no filesystem arguments are present. 


FILES 
/ete/checklist 


SEE ALSO 
fsck(1M), ncheck(1M) 
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NAME 
constab — constructed devices table 

DESCRIPTION 
constab resides in directory /etc and contains a table of virtual devices which 
have been built by the devbuild(1M) command. The devdestroy(1M) com- 
mand removes entries from this file. 
The file contains a line of information for each constructed device, and is 
structurally similar to the contents of /etc/devtab as described in devtab(4), 
with the exception that only the first two columns are represented. 


The entries from the constab file are accessed using the routines in 
read_constab(3SEQ) or printed via devbuild(1M). 


FILES 
/etc/constab 


SEE ALSO 
devbuild(1M), devdestroy(1M), read_constab(3SEQ), devtab(4) 
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NAME 


core — format of core image file 


© DESCRIPTION 


The operating system writes out a memory image of a terminated process 
when any of various errors occur (see signal(2) for a list of errors). The most 
common errors are memory violations, illegal instructions, bus errors, and 
user-generated quit signals. The core image is called core and is written in 
the process’s working directory, provided access it allowed. A process with an 
effective user ID different from the real user ID, or an effective group ID dif- 
ferent from the real group ID, will not produce a core image. 


The first section of a core image is a copy of the system’s per-user data for the 
process, including the registers as they were at the time of the fault. The size 
of this section depends on the parameter UPAGES, which is defined in 
<sys/mc_param.h>. The remainder represents the actual contents of the 
user’s core area when the core image was written. If the text segment is read- 
only and shared, or separated from data space, it is not dumped. 


The format of the information in the first section is described by the user 
structure of the system, defined in <sys/user.h>. The location of the registers 
are outlined in <sys/reg.h>. 


SEE ALSO 
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NAME 


cpio — format of cpio archive 


eS DESCRIPTION 


The header structure, when the -c option of epio(1) is not specified, is as fol- 
lows: 


struct { 
short h_magic, 
h_dev; 
ushort h_ino, 
h_mode, 
h_uid, 
h_gid; 
short h_nlink, 
h_rdev, 
h_mtime[2], 
h_namesize, 
h_filesize[2]; 
char h_name [h_namesize rounded to word]; 
} Hdr; 


If—c is specified, the header information is described by the following: 


sscanf (Chdr, "%60%60% 60% 60% 60% 60% 60% 60%111lo%60%11lots", 
&Hdr.h_magic, &Hdr.h_dev, &Hdr.h_ino, &Hdr.h_mode, 
&Hdr.h_uid, &Hdr.h_gid, &Hdr.h_nlink, &Hdr.h_rdev, 
&Longtime, &Hdr.h_namesize, &Longfile,Hdr.h_name) ; 


Longtime and Longfile are equivalent to Hdr.h_mtime and Hdr.h_filesize, 
respectively. The contents of each file are recorded in an element of the array 
of varying length structures, archive, together with other items describing the 
file. Every instance of h_magic contains the constant 070707 (octal). The 
items h_dev through h_mtime have meanings explained in stat(2). The 
length of the null-terminated pathname h_name, including the null byte, is 
given by h_namesize. 


The last record of the archive always contains the name TRAILER. Special 
files, directories, and the trailer are recorded with h_filesize equal to zero. 


SEE ALSO 
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stat(2), cpio(1), find(1) 
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NAME 


© cronlog — cron history file 
DESCRIPTION 


A history of al] actions taken by /ete/cron is recorded in the /usr/lib/cron/log 
file. The /usr/lib/cron/log file should be periodically truncated to keep the 
size of the file within a reasonable limit. Note that /etc/cron, /etc/rc0, or 
/ete/rc2 can be used to clean up the /usr/lib/cron/log file. To use one of these 
functions to limit the size of a log file, add the appropriate command line to 
the /usr/spool/cron/crontab/root, /etc/shutdown.d/..., or /etc/re.d/ rc2.d, 
re8.d ... file, as applicable. The following command line limits the size of the 
log file to the last 100 lines in the file: 


tail -100 /usr/lib/cron/log > /tmp/log; mv /tmp/log /usr/lib/cron/log 


EXAMPLES 
The following is an example of a typical /usr/lib/cron/log file. 


*** cron started *** pid = 237 Sun Aug 19 14:06:45 1989 
CMD; /usr/lib/uucp/uudemon.hour > /dev/null 
root 251 c Sun Aug 19 14:11:00 1984 
root 251 c Sun Aug 19 14:11:01 1984 
CMD: /usr/lib/uucp/uudemon.poll > /dev/null 
root 370 c Sun Aug 19 14:30:00 1984 
root 370 c Sun Aug 19 14:30:03 1984 
CMD; /usr/lib/uucp/uudemon.hour > /dev/null 
root 417 c Sun Aug 19 14:41:01 1984 
root 417 c Sun Aug 19 14:41:02 1984 
CMD; /usr/lib/uucp/uudemon.poll > /dev/null 
root 452 c Sun Aug 19 15:01:00 1984 
root 452 c Sun Aug 19 15:01:04 1984 
CMD: /usr/lib/uucp/uudemon.hour > /dev/null 
root 460 c Sun Aug 19 15:11:00 1984 
root 460 c Sun Aug 19 15:11:00 1984 
CMD: /usr/lib/uucp/uudemon.poll > /dev/null 
root 541 c Sun Aug 19 15:30:00 1984 
root 541 c Sun Aug 19 15:30:07 1984 


AVVAVVAVVAVVANVVANV VO 
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NAME 


crontabs — clock daemon file 


@ DESCRIPTION 
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The /usr/spool/cron/crontabs directory contains crontab files for adm, 
root, and sys logins. Providing their lognames are in the 
/usr/lib/cron/cron.allow file, users can establish their own crontabs file 
using the crontab command. If the cron.allow file does not exist, the 
/usr/lib/cron/cron.deny file is checked to determine if the user is denied the 
use of the crontab command. 


As root, you can either use the crontab(1) command or edit the appropriate 
file under /usr/spool/cron/crontabs to make the desired entries. Revisions to 
the file take effect at the next reboot. 


The line entry format of a /usr/spool /cron/crontabs/logname file is as fol- 
lows: 


minute hour day month day-of-week command 


The various fields of a crontabs/logname line entry are as follows: 


minute The minutes field is a one- or two-digit number in the range 0 
through 59. 

hour The hour field is a one- or two-digit number in the range 0 
through 24. 

day The day field is the numerical day of the month in the range 1 
through 31. 

month The month field is the numerical month of the year in the 


range 1 through 12. 


day-of-week The day-of-week field is the numerical day of the week where 
Sunday is 0, Monday is 1, ... and Saturday is 6. 


command The command field is the program or command that is exe- 
cuted at the time specified by the first five fields. 


The following syntax applies to the first five fields: 


¢ Two numbers separated by a minus indicates an 
inclusive range of numbers between the two specified numbers. 


¢ Alist of numbers separated by commas specifies 
all of the numbers listed. 


¢ An asterisk specifies all legal values. 


In the command field (sixth field), a percent sign (%) is translated to a new- 
line character. Only the first line of a command field (character string up to 
the percent sign) is executed by the shell. Any other lines are made available 
to the command as standard input. The example that follows shows a typical 
/usr | spool /cron/crontabs/logname file. The data shown are the root file. 
The file entries support the calendar reminder service and basic networking. 
Remember, you can use the cron function to decrease the number of data ter- 
minal driven system administration tasks: include recurring and habitual 
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tasks in your crontab file. 


EXAMPLES ae) 
o1* * * /usr/bin/calendar - 


41,11 * * * * /usr/lib/uucp/uudemon.hour > /dev/null 

45 23 * * * ylimit 5000; /bin/su uucp -c "/usr/uudemon.cleanup" 
> /dev/null 2>&1 

1,30 * * * * /usr/lib/uucp/uudemon.poll > /dev/null 
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NAME 
devtab — virtual device table 


DESCRIPTION 
The /etc/devtab file contains information about virtual device bindings for use 
by devbuild(1M). Each entry in /etc/devtab has the following format. 


Column1_ Virtual device type 
Column 2 Root of virtual device tree 
Column 3 Parameters to device builder 


Virtual device type is one of a set of supported virtual devices. Each virtual 
device type is supported by an executable in /etc/devbuild.d, so the list of sup- 
ported virtual devices can be listed by examining this directory. The system is 
distributed with two virtual device types: vtoc(7), a partitioning driver based 
on the "Volume Table of Contents" (VTOC) present on the disk, and empt(7), a 
partitioning driver which supplies compatibility partitions for previous ver- 
sions of the system. Refer to each virtual driver’s manual page for the format 
of their respective devtab entries. 


FILES 
/etc/devtab 
/etc/devbuild.d 
SEE ALSO 
devbuild (1M), devdestroy (1M), constab (4), vtoc (7), cmpt (7) 
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NAME 


DIR(4) 


dir — format of directories 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ufsdir.h> 


DESCRIPTION 


A directory behaves exactly like an ordinary file, except that no user may 
write into a directory. The fact that a file is a directory is indicated by a bit in 
the flag word of its i-node entry (see fs(4)). The structure of a directory entry 
as given in the include file is: 


i 


*A directory consists of some number of blocks of 


+ + OF FF HF FF HF HH HF FF HH HF FF FH HF HF HH HH OH 


*/ 


DIRBLKSIZ bytes, where DIRBLKSIZ is chosen such 
that it can be transferred * to disk in a single 
atomic operation (e.g. 512 bytes on most machines). 
Each DIRBLKSIZ byte block contains some number of 
directory entry structures, which are of variable 
length. Each directory entry has a struct direct 
at the front of it, containing its inode number, 
the length of the entry, and the length of the 
name contained in * the entry. These are followed 
by the name padded to a 4 byte boundary with null 
bytes. All names are guaranteed null terminated. 
The maximum length of a name in a directory is 
UFS_MAXNAMLEN. 


The macro DIRLEN(dp) gives the amount of space 
required to represent a directory entry. Free 
space in a directory is represented by entries 
which have dp->d_reclen > DIRLEN(dp). All 
DIRBLKSIZ bytes in a directory block are claimed 
by the directory entries. This usually results 

in the last entry in a directory having a large 
dp->d_reclen. When entries are deleted froma 
directory, the * space is returned to the previous 
entry in the same directory block by increasing its 
dp->d_reclen. If the first entry of a directory 
block is free, then its dp->d_ino is set to 0. 
Entries other than the first in a directory do not 
normally have dp->d_ino set to 0. 


#define DIRBLKSIZ DEV_BSIZE 


#define UFS_MAXNAMLEN 255 


/* 
* 
* 
* 
* 
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The DIRLEN macro gives the minimum record length 
which will hold the directory entry. This requires 
the amount of space in struct direct without the 
d_name field, plus enough space for the name with 


DIR(4) DYNIX/ptx 


* a terminating null byte (dp->d_namlen+1), rounded 
* up to a 4 byte boundary. 
*/ 
#undef DIRLEN 
#define DIRLEN(dp) \ 

((sizeof (struct direct) - (UFS_MAXNAMLEN+1)) + 
(( (dp) ->d_namlent+l + 3) &~ 3)) 


struct direct { 
ulong d_ino; 


short d_reclen; 
short d_namlen; 
char d_name[UFS_MAXNAMLEN + 1]; 


/* typically shorter */ 
‘e 


By convention, the first two entries in each directory are for ‘” and‘... The 
first is an entry for the directory itself. The second is for the parent directory. 
The meaning of ‘..’ is modified for the root directory of the master file system 
(A, where ‘..” has the same meaning as a 

Applications which read directories to get filenames from it should use the 
opendir(3X), and readdir(3X) library calls. 


SEE ALSO 
fa(4), dirent(4), directory(3x) 
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NAME 


dirent — file system independent directory entry 


SYNOPSIS 


#include <sys/dirent.h> 
#include <sys/types.h> 


DESCRIPTION 


FILES 


Different file system types may have different directory entries. The dirent 
structure defines a file system independent directory entry, which contains 
information common to directory entries in different file system types. A set of 
these structures is returned by the getdents(2) system call. 


The dirent structure is defined below. 
structdirent { 


long d_ino; 
off_t a_off; 
unsigned short d_reclen; 
char d_name [1]; 


ye ' 
The d_ino is a number which is unique for each file in the file system. The 
field d_off is the offset of that directory entry in the actual file system direc- 
tory. The field d_name is the beginning of the character array giving the 
name of the directory entry. This name is null terminated and may have at 
most MAXNAMLEN characters. This results in file system independent 
directory entries being variable length entities. The value of d_reclen is the 
record length of this entry. This length is defined to be the number of bytes 
between the current entry and the next one, so that it always results in the 
next entry being on a long boundary. 


/usr/include/sys/dirent.h 


SEE ALSO 
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getdents(2) 
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NAME 


diskinfo — disk device characteristic database 


SYNOPSIS 


/etc/diskinfo/* 


DESCRIPTION 


diskinfo is a database which describes characteristics of disk devices; that is, 
those devices which need to be formatted and/or those devices on which a 
VTOC will be placed. The directory /etc/diskinfo is populated with text files 
that describe different classes of disk characteristics. 


Each type of disk is assigned a symbolic name which is usually the model 
number of the particular disk — for example, "m2333k" for the Fujitsu "Swal- 
low 8." Each file in /etc/diskinfo has a prefix which is the name of a disk type. 
The suffix of the filename defines the class of disk information present on this 
particular disk model. For example, m2333k.geom will contain the geometry 
information for all model M2333K disks. 


Lines in diskinfo files are patterned after the terminfo(4) database. Below 
is a general description of lines in these files. 


diskinfo files consist of usually one device description entry. Each entry con- 
sists of a header (beginning in column 1) and one or more lines that list the 
features for that particular device. Each line in a diskinfo file, except the 
header, must be indented with one or more white spaces (either spaces or 
tabs). 


Entries consist of a number of colon-separated fields. The following example 
shows the format of a diskinfo source file: 


alias1 | alias2 | ... | aliasN | longname: 
namel#value1:name2#value2: ... 


The first line, commonly referred to as the header line, must begin in column 
one and must contain one or more aliases, separated by vertical bars. The last 
field in the header line may be the long name of the device and it may contain 
any string. Alias names must be unique within files of a given suffix in the 
diskinfo database and they must conform to operating system file naming 
conventions; for example they cannot contain white space or slashes. 


GEOMETRY INFORMATION 
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Files in /etc/diskinfo with the suffix .geom contain disk geometry information, 
such as the size of tracks and cylinders, and the size of the disks themselves. 
This information is usually common to all disks, and is used by the system to 
optimize access to data by grouping related disk blocks relatively close 
together. The information is also used by system maintenance utilities (such 
as formatters) so that they can agree on reserved disk areas. 


The following list indicates the normal values stored for each disk entry. 
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Name Type Description 

cy num Number of sectors per cylinder 
dc num Capacity of disk in sectors 

ns num Number of sectors per track 
nt num Number of tracks per cylinder 
ne 
rm 
se 
xe 


num ___‘ Total number of cylinders on the disk 
num Number of revolutions per minute 
num __ Sector size in bytes (512 by default) 
num Minimum disk capacity in sectors 


Note that even though the number of sectors per track and tracks per cylinder 
are given, the number of sectors per cylinder is not necessarily equal to the ns 
and nt values multiplied together. Also, the capacity of the whole disk may 
not be derivable from any of the other parameters. This is due to the con- 
struction of disks which have a variable number of sectors per track depend- 
ing on the cylinder number, and disks which have extra sectors on each cylin- 
der. 


The xc parameter describes the guaranteed minimum number of sectors on 
the disk. This is needed for disk devices which vary their reported size based 
on the number of bad blocks which have been revectored on the disk. The xe 
parameter is used by programs which need to varify the disk type by seeking 
to the last known sector of the disk. The xc parameter is normally not 
present for most disk types. 


The information in the .georm files can be retrieved in a program using the get- 
geombyname(3SEQ) interface. 


SCSI INFORMATION 
Files in /etc/diskinfo with the suffix .scsi contain information specific to CCS 
(common command set) SCSI disks which is used by the online format pro- 
gram. This data should correspond to fields in the drive_table entries in 
/etc/conf/ stand /conf_scsi.c. 


The following list defines the two character keys used to identify each field 
within the file. Each of these fields is required by the online formatter to be in 


the file. 

Name Type _ Description 

vn string Vendor (this must be padded to 8 chars) 

pr string Product number (this must be padded to 16 chars) 

iq num Inquiry command format 

re num Size in bytes of REASSIGN_BLOCK data 

fm num Format code for the FORMAT command 

Note that the vendor and product number must match the strings returned by 
the SCSI INQUIRY command. 


The information in the .scsi files can be retrieved in a program using the 
getscsimatch(3SEQ) interface, which requires the vendor and products 
strings to be passed in as arguments, and then finds the .scsi file which 
matches. 


ZD INFORMATION 


Files in /etc/diskinfo with the suffix .zd contain information specific to ZDC 
disks which is used by the online format program. This data should 


2 , 12/89 


DYNIX/ptx DISKINFO(4) 


correspond to fields in the zdinfo table entries in /etc/conf/stand /conf_zd.c 
and should not be changed, since it used to construct channel configuration 
information used by the ZDC controller board. 


The following list defines the two character keys used to identify each field 
within the file. Each of these fields is required to be in the file. Compare with 
the zdedd structure defined in <sys/zdc.h>. 


Name Type Description 

mg num magic number for sanity 

ec num number of bytes of ECC 

sp num _ spares per track 

Be num _ sectors per track (formatted) 

tr num __ tracks per cylinder 

cy num number of cylinders 

dt num soft drive type (type it was formatted as). 
xf num ___ drive transfer rate in MHz 

ru num number of bytes in runt sector 
ch num__ channel delay 

hs num __shead switch delay 

hr num header postamble byte cnt (read) 
hf num header postamble byte cnt (fmt) 


ck num format skew between cylinders 

tk num format skew between tracks 

hb num header byte ent (inc head scatter) 

sb num __ sector byte ent (inc header & gap) 
@ si num bytes at sector start where defects can be ignored 

ei num _ bytes at sector end where defects can be ignored 

ds num__— RO status register 

de num_ RO error register 

po num ___— polynomial preset byte 0 

pl num ___ polynomial preset byte 1 

p2 num _ polynomial preset byte 2 

p3 num __ polynomial preset byte 3 

p4 num __ polynomial preset byte 4 

pd num ___ polynomial preset byte 5 

t0 num __ polynomial tap byte 0 

t1 num __s polynomial tap byte 1 

t2 num __ polynomial tap byte 2 

t3 num __ polynomial tap byte 3 

t4 num ___ polynomial tap byte 4 

t5 num __— polynomial tap byte 5 

er num ECC/CRC control 

he num _esheader byte count 

dc num _—_ drive command register 

oc num operation command register 

sc num __ sector count 

ns num __s number of sector operations 
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ho num _sheader byte 0 pattern 

hl num header byte 1 pattern 

h2 num header byte 2 pattern 

h8 num header byte 3 pattern 

h4 num header byte 4 pattern 

hd num header byte 5 pattern 

rd num __ remote data byte count 

dm num DMA address 

do num _ data postamble byte count 

rh num header preamble byte count 
sl num __sheader synch #1 byte count 
82 num header synch #2 byte count 
c0 num header byte 0 control 

cl num header byte 1 control 

c2 num header byte 2 control 

c3 num header byte 3 control 

c4 num header byte 4 control 

cB num header byte 5 control 

xd num __ external data ECC byte count 
xh num __ external header ECC byte count 
po num __header postamble byte count (write) 
pr num _ data preamble byte count (write) 
dl num__ data synch #1 byte count 

d2 num __ data synch #2 byte count 

op num __ data postamble pattern 

or num header preamble pattern 

al num header synch #1 pattern 

a2 num header synch #2 pattern 

gp num __ gap byte count 

df num ___ disk format register 

It num ___local transfer register 

rt num __ remote transfer register 

et num __ sector byte count 

gt num gap pattern 

fd num ___ data format pattern 

ah num header postamble pattern 

ad num __ data preamble pattern 

rl num _ data synch #1 pattern 

12 num __ data synch #2 pattern 


The information in the .zd files can be retrieved in a program using the 
getzdinfobyname(3SEQ) interface. 


/ete/diskinfo/* /etc/conf/stand/conf_scsi.c /etc/conf/stand/conf_zd.c 


SEE ALSO 
getgeombyname (3SEQ), getscsimatch (3SEQ), getzdinfobyname (3SEQ), 


mkvtoc (1M), format (1M) 
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NAME 
@ dump, dumpdates — incremental dump format 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/ufsinode.h> 
#include <dumprestore.h> 


DESCRIPTION 
Tapes used by dump and restore(1M) contain the following: 


a header record 

two groups of bit map records 

a group of records describing directories 
a group of records describing files 


The format of the header record and of the first record of each description as 
given in the include file <dumprestore.h> is: 


#define NTREC 10 
#define HIGHDENSITYTREC 32 
#define MLEN 16 
#tdefine MSIZ 4096 


#define TS_TAPE a 
#define TS_INODE 2 
#define TS_BITS 3 
#define TS_ADDR 4 
© #define TS_END 5 
#define TS_CLRI 6 
#define MAGIC (int) 60012 
#define CHECKSUM (int) 84446 


structspel { 


int c_type; 
time_t c_date; 
time_t c_ddate; 
int c_volume; 
daddr_t c_tapea; 
ino_t c_inumber; 
int c_magic; 
int c_checksum; 
struct dinode c_dinode; 
int ¢_count; 
char c_addr [BSIZE]; 
char c_label[LBLSIZE]; 
long c_level; 
char c_filesys[NAMELEN] ; 
char c_dev[NAMELEN]; 
char c_host [NAMELEN] ; 
} spel; 
@ structidates { 
char id_name[16]; 
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char id_incno; 
time_t id_ddate; 
i 
#define DUMPOUTFMT "%-16s %c %s” 


#define 


/* for printf */ 

/* name, incno, ctime(date) */ 
DUMP INFMT "$16s %c %[*\n]\n" 

/* inverse for scanf */ 


NTREC is the number of 1024 byte records in a physical tape block, unless a 
6250 BPI density or higher tape is used, in which case the number of 1024 
byte records in a physical tape block is HIGHDENSITYTREC. MLEN is the 
number of bits in a bit map word. MSIZ is the number of bit map words. 


The TS_ entries are used in the c_type field to indicate what sort of header 
this is. The types and their meanings are as follows: 


TS_TAPE 
TS_INODE 


TS_BITS 


TS_ADDR 
TS_END 
TS_CLRI 


MAGIC 
CHECKSUM 


Tape volume label 


A file or directory follows. The c_dinode field is a copy of the 
disk inode and contains bits telling what sort of file this is. 


Abit map follows. This bit map has a one bit for each inode that 
was dumped. 


A subrecord of a file description. See c_addr below. 
End of tape record. 


Abit map follows. This bit map contains a zero bit for all inodes 
that were empty on the file system when dumped. 


All header records have this number in c_magic. 
Header records checksum to this value. 


The fields of the header structure are as follows: 


c_type 
c_date 
c_ddate 
c_volume 
c_tapea 
c_inumber 


c_magic 
c_checksum 
c_dinode 


c_count 
c_addr 


The type of the header. 

The date the dump was taken. 

The date the file system was dumped from. 

The current volume number of the dump. 

The current number of this (1024-byte) record. 

The number of the inode being dumped if this is of type 
TS_INODE. 

This contains the value MAGIC above, truncated as needed. 


This contains whatever value is needed to make the record sum 
to CHECKSUM. 

This is a copy of the inode as it appears on the file system; see 
fa(5). ‘ 
The count of characters in c_addr. 

An array of characters describing the blocks of the dumped file. 
Acharacter is zero if the block associated with that character 
was not present on the file system, otherwise the character is 
non-zero. If the block was not present on the file system, no 
block was dumped; the block is restored as a hole in the file. If 
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FILES 


there is not sufficient space in this record to describe all of the 
blocks in a file, TS_ADDR records are scattered through the file, 
each one picking up where the last left off. 


c_label Contains the dump level, not currently used. 

c_level The increment level of this dump. 

c_filesys The name of the filesystem (mount point) which was dumped on 
this tape. 

c_dev The name of the disk device which contained the file system 
which was dumped on this tape. 

c_host The name of the host on which the dump took place. 


Each volume except the last ends with a tapemark (read as an end of file). 
The last volume ends with a TS_END record and then the tapemark. 


The structure idates describes an entry in the file /etc/dumpdates where 
dump history is kept. The fields of the structure are: 


id_mame The dumped filesystem is ‘/dev/id_nam’. 
id_incno The level number of the dump tape; see dump(8). 
id_ddate The date of the incremental dump in system format see types (5). 


/etc/dumpdates 


SEE ALSO 
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dump(1M), restore(1M), types(5) 
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NAME 


.environ, .pref, .variables — FACE files 


DESCRIPTION 
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The .environ file contains system-wide FACE environment variables. The 
-pref file contains the defaults for WASTEBASKET and FILECABINET. The 
-variables file contains variables to set the editor and the shell prompt. 
These files are used for a variety of FACE operations. 


The .environ and .variables files are located in the user’s $HOME/pref 
directory. The .pref files are found under $HOME/FILECABINET, 
$HOME/WASTEBASKEET, and any directory where preferences were set with 
the organize command. Names and descriptions for each variable are 
presented below. Variables are listed one per line and are of the form "vari- 
able=value”. 


Variables found in .environ are as follows: 


LOGINWIN1 ... LOGINWIN4 
Windows that are opened when FACE is initialized 


SORTMODE Sort mode for file folder listings. Values include the fol- 
lowing hexadecimal digits: 


1 sort alphabetically by name 
2 files most recently modified first 
800 __ sort alphabetically by object type 


The values above may be listed in reverse order by 
"ORing" the following value: 


1000 list objects in reverse order 


For example, a value of 1002 produces a folder listing with 
files LEAST recently modified displayed first. A value of 
1001 produces a reverse alphabetical by name listing of 
the folder. 


DISPLAYMODE Display mode for file folders. Values include the following 
hexadecimal digits: 


0 file names only 
4 file names and brief description 
8 file names, description, plus additional information 


WASTEPROMPT Prompt before emptying wastebasket (yes/no)? 


- WASTEDAYS # days before emptying wastebasket 


PRINCMD1 ... PRINCMDS 
Print command defined to print files 


UMASK Holds default permissions that files will be created with. 
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Variables found in -pref are SORTMODE and DISPMODE, which can have the 
same values as the SORTMODE and DISPLAYMODE variables described in 
environ above. 


Variables found in .variables are EDITOR indicating the default editor, and 
PS&1 indicating the shell prompt. 


FILES 
$HOME/pref/.environ 
$HOME)pref/.variables 
$HOME/FILECABINET/. pref 
$HOME/WASTEBASKET/.pref 
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NAME 
errorlog — internal error log file 


DESCRIPTION 
The error log file contains all internal menu system errors and failed system 
calls that occur during user activity. The System Admininstrator can inspect 
this log periodically to review the types of errors, if any, that are occurring. 
This log is also reviewed when the menu program (menuprom) will not start 
up or is not working properly. 


Asingle error may result in more than one entry in the error log file. Because 
the system checks each subroutine’s return code, an error may cascade 
through several levels of subroutine calls before the initial subroutine that 
was called is notified of the error. 


FIELDS 
Date 
The date the internal error occurred (format: MM/DD/YY). This is a required 
field. 
Time 
The time the internal error occurred (format: HH.MM.SS., based on a 24 hour 
clock). This is a required field. 


Message Number 
Number assigned to the error. This is a required field. 


Executable Program 
Name of the executable binary that detected the error. This is a required 
field. 


Subroutine Name 
Name of the subroutine that detected the error. This is a required field. 


Message Text 
The Message Text is extracted from the Error Message file based on the mes- 
sage number. It describes the error that occurred. It may also be displayed on 
the screen when the error occurs. This is a required field. 


UNIX System Error Text 
Some system errors fail with a diagnostic number. The diagnostic number is 
equivalent to the error number for the UNIX perror() system call. Thisisa 


optional field. 
FILES 
${TFADMFILE)/misc/errorlog Interal Error Log File 
${TFADMFILE}/misc/errormsg TaskForce Error Message File 
NOTES 


Alteration of this file is not recommended. When a system malfunction is 
detected, inspect this file to uncover the error. 
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NAME 
errormsg — error message text file 


DESCRIPTION 
The error message file contains the text of all error messages that are the 
result of internal menu system errors. All messages are referenced by number 
in the menu system source code. When an internal failure is detected, the text 
for the error message is retrieved by the tferror() routine in the menu sys- 
tem. The error message is then displayed on the screen or written in the 
menu system’s Internal Error Log File. 


FIELDS 
Message Number 
When an error occurs, a message number is passed to the tferror() routine. 
The system searches this file for a record with the same number. This isa 
required field. 
Message Text 


The text returned to the tferror() routine. It may be displayed on the screen 
or written to the internal menu system Error Log. This is a required field. 


FILES 
$(TFADMFILE)/etc/errormsg Error Message Text File 
${TFADMFILE)/nisc/errorlog TaskForce Internal Log File 
SEE ALSO 


menu(1M), ede(1M) 


NOTES 
The alteration of this file is not recommended. 
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NAME 


FILEHDR(4) 


filehdr — file header for common object files 


SYNOPSIS 
#include <filehdr.h> 


DESCRIPTION 


Every common object file begins with a 20-byte header. The following C 


struct declaration is used: 


struct filehdr 
{ 


unsigned short f_magic 


/* magic number */ 


unsigned short f_nscns ; /* number of sections */ 


long f£_timdat 
long f_symptr 
long f_nsyms ; 


; 
? 


/* time & date stamp */ 
/* file ptr to symtab */ 
/* # symtab entries */ 


unsigned short f_opthdr ; /* sizeof(opt hdr) */ 
unsigned short f_flags ; /* flags */ 


de 


f_symptr is the byte offset into the file at which the symbol table can be 
found. Its value can be used as the offset in fseek(3S) to position an I/O 
stream to the symbol table. The optional header is 28-bytes. The valid magic 


numbers are given below: 


#define —~ 0524 /* Sequent Symmetry computers */ 
The value in f_timdat is obtained from the time(2) system call. Flag bits cur- 


rently defined are: 


#define ~ 0000001 
#define ~ 0000002 
#tdefine ~ 0000004 
#define ~ 0000010 
#define ~ 0000020 
#define ~ 0000040 
#define ~ 0000100 
#define —~ 0000200 
#define ~ 0000400 
#define ~ 0001000 
#define ~ 0002000 
#define ~ 0160000 
#define ~ 0020000 


#define —~ 0040000 
#define —~ 0010000 
SEE ALSO 
time(2), fseek(3S), a.out(4) 
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/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


relocation entries stripped */ 
file is executable */ 

line numbers stripped */ 

local symbols stripped */ 
minimal object file */ 

update file, ogen produced */ 
file is "pre-swabbed" */ 
16-bit DEC host */ 

32-bit DEC host */ 

non-DEC host */ 

"patch" list in opt hdr */ 
WE32000 family ID field */ 
file contains WE 32100 code */ 
file reqs MAU to execute */ 
this object file contains restore 
work around [3B5/3B2 only] */ 
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NAME 
fs, inode — format of file system volume 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ufsfilsys.h> 
#include <sys/ufsinode.h> 

DESCRIPTION 
Every file system storage volume (disk, nine-track tape, for instance) has a 
common format for certain vital information. Every such volume is divided 
into a certain number of blocks. The block size is a parameter of the file sys- 
tem. Sectors beginning at BBLOCK and coutinuing for BBSIZE are used to con- 
tain primary and secondary bootstrapping programs. 
The actual file system begins at sector SBLOCK with the super block that is of 
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size SBSIZE. The layout of the super block as defined by the include file 


<sys /ufsfilsys.h> is: 

#define FS_MAGIC 0x011954 

structfs { 
struct fs *fs_link; /* linked list of file systems */ 
struct fs *fs_ rlink; /* used for incore super blocks */ 


daddr_t fs_sblkno; /* addr of superblock in filesys */ 
daddr_t fs_cblkno; /* offset of cyl-block in filesys */ 
daddr_t fs_iblkno; /* offset of inode-blocks in filesys */ 
daddr_t fs_dblkno; /* offset of first data after cg */ 
long fs_cgoffset; /* cylinder group offset in cylinder */ 
long fs_cgmask; /* used to calc mod fs_ntrak */ 

time_t fs_time; /* last time written */ 

long fs_size; /* number of blocks in fs */ 

long fs_dsize; /* number of data blocks in fs */ 

long fs_ncg; /* number of cylinder groups */ 

long fs_bsize; /* size of basic blocks in fs */ 

long fs_fsize; /* size of frag blocks in fs */ 

long fs_frag; /* number of frags in a block in fs */ 


/* these are configuration 


parameters */ 


long fs_minfree; /* minimum percentage of free blocks */ 
long fs_rotdelay; /* num of ms for optimal next block */ 
long fs_rps; /* disk revolutions per second */ 


/* these fields can be computed from the others */ 


long fs_bmask; /* ‘‘blkoff£’’ calc of blk offsets */ 

long fs_fmask; /* ‘‘fragoff’’ calc of frag offsets */ 
long fs_bshift; /* **‘lblkno’’ calc of logical blkno */ 
long fs_fshift; /* **numfrags’' calc number of frags */ 


/* these are configuration parameters */ 

fs_maxcontig; /* max number of contiguous blks */ 
/* max number of blks per cyl group */ 
/* these fields can be computed from the others */ 


long 
long 


fs_maxbpg; 


long fs_fragshift; /* block to frag shift */ 

long fs_fsbtodb; /* fsbtodb and dbtofsb shift constant */ 
long fs_sbsize; /* actual size of super block */ 

long fs_csmask; /* csum block offset */ 
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long fs_csshift; /* csum block number */ 
long fs_nindir; /* value of NINDIR */ 
long fs_inopb; /* value of INOPB */ oS 
long fs_nspf; /* value of NSPF */ 
/* yet another configuration parameter */ 
long fs_optim; /* optimization preference, see below */ 
/* these fields are derived from the hardware */ 
long fs_npsect; /* # sectors/track including spares */ 
long fs_interleave;/* hardware sector interleave */ 
long fs_trackskew; /* sector 0 skew, per track */ 
long fs_headswitch;/* head switch time, usec */ 
long fs_trkseek; /* track-to-track seek, usec */ 


/* sizes determined by number of cylinder groups and sizes */ 
daddr_t fs_csaddr; /* blk addr of cyl grp summary area */ 


long fs_cssize; /* size of cyl grp summary area */ 
long fs_cgsize; /* cylinder group size */ 
/* these fields should be derived from the hardware */ 
long fs_ntrak; /* tracks per cylinder */ 
long fs_nsect; /* sectors per track */ 
long fs_spc; /* sectors per cylinder */ 
/* this comes from the disk driver partitioning */ 
long fs_ncyl; /* cylinders in file system */ 
/* these fields can be computed from the others */ 
long fs_cpg; /* cylinders per group */ 
long fs_ipg; /* inodes per group */ 
long fs_fpg; /* blocks per group fs_frag */ 


/* this data must be re-computed after crashes */ 
struct csum fs_cstotal; 
/* cylinder summary information */ 
/* these fields are cleared at mount time */ 


char fs_fmod; /* super block modified flag */ 
char fs_clean; /* file system is clean flag */ 
char fs_ronly; /* mounted read-only flag */ 
char fs_flags; /* currently unused flag */ 


char fs_fsmnt [MAXMNTLEN] ; 

/* name mounted on */ 
char fs_fname[6]; /* file system name */ 
char fs_fpack[6]; /* file system back name */ 

/* these fields retain the current block allocation info */ 
long fs_cgrotor; /* last cg searched */ 
struct csum *fs_csp[(MAXCSBUFS]; 

/* list of fs_cs info buffers */ 
long fs_cpc; /* cyl per cycle in postbl */ 
short fs_opostbl[16] [8]; 

/* old rotation block list */ 


long f£s_sparecon[53]; 
/* reserved for future constants */ 
long fs_id[2]; /* file system ID */ 
long fs_state; /* file system state */ 
quad f£s_qbmask; /* ~fs_bmask - for use with quad size */ 


quad fs_qfmask; /* “fs fmask - for use with quad size */ 


DYNIX/ptx FS(4) 


12/89 


long fs_postblformat; 
/* format of positional layout tables */ 


long fs_nrpos; /* number of rotaional positions */ 
long fs postbloff; /* (short) rotation block list head */ 
long fs rotbloff; /* (unchar) blocks for each rotation */ 
long fs_magic; /* magic number */ 


unchar fs space(1]; /* list of blocks for each rotation */ 
/* actually longer */ 
Me 


Each disk drive contains some number of file systems. A file system consists of 
a number of cylinder groups. Each cylinder group has inodes and data. 


A file system is described by its superblock, which in turn describes the cylin- 
der groups. The superblock is critical data and is replicated in each cylinder 
group to protect against catastrophic loss. This is done at file system creation 
time and the critical superblock data does not change, so the copies need not 
be referenced further unless disaster strikes. 


Addresses stored in inodes are capable of addressing fragments of ‘blocks’. File 
system blocks of at most size MAXBSIZE can be optionally broken into 2, 4, or 
8 pieces, each of which is addressable; these pieces may be DEV_BSIZE, or 
some multiple of a DEV_BSIZE unit. 


Large files consist of exclusively large data blocks. To avoid undue wasted 
disk space, the last data block of a small file is allocated as only as many frag- 
ments of a large block as are necessary. The file system format retains only a 
single pointer to such a fragment, which is a piece of a single large block that 
has been divided. The size of such a fragment is determinable from informa- 
tion in the inode, using the “blksize(fs, ip, lbn)” macro. 


The file system records space availability at the fragment level; to determine 
block availability, aligned fragments are examined. 


The root inode is the root of the file system. Inode 0 cannot be used for normal 
purposes and historically bad blocks were linked to inode 1, thus the root 
inode is 2 (inode 1 is no longer used for this purpose, however numerous dump 
tapes make this assumption, 80 it remains). The lost+found directory is given 
the next available inode when it is initially created by mkfs. 


fs_minfree gives the minimum acceptable percentage of file system blocks 
which may be free. If the freelist drops below this level only the superuser 
may continue to allocate blocks. /s_minfree may be set to 0 if no reserve of free 
blocks is deemed necessary, however severe performance degradations will be 
observed if the file system is run at greater than 90% full; thus the default 
value of fs_minfree is 10%. 


The best trade-off between block fragmentation and overall disk utilitization 
at a loading of 90% comes with a fragmentation of 8, thus the default fragment 
size is an eighth of the block size. 


Cylinder group related limits: Each cylinder keeps track of the availability of 
blocks at different rotational positions, so that sequential blocks can be laid 
out with minimum rotational latency. With the default of 8 distinguished 
rotation positions, the resolution of the summary information is 2ms for a typ- 
ical 8600 rpm drive. 
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fs_rotdelay gives the minimum number of milliseconds to initiate another disk 
transfer on the same cylinder. It is used in determining the rotationally 
optimal layout for disk blocks within a file; the default value for /s_rotdelay is 
2ms. 


Each file system has a statically allocated number of inodes. An inode is allo- 
cated for each NBPI bytes of disk space. The inode allocation strategy is 
extremely conservative. 


MINBSIZE is the smallest allowable block size. With a MINBSIZE of 4096 it 
is possible to create files of size 2°32 with only two levels of indirection. 
MINBSIZE must be big enough to hold a cylinder group block, thus changes to 
(struct cg) must keep its size within MINBSIZE. Note that super blocks are 
never more than size SBSIZE. 


The path name on which the file system is mounted is maintained in fs_fsmnt. 
MAXMNTLEN defines the amount of space allocated in the super block for this 
name. The limit on the amount of summary information per file system is 
defined by MAXCSBUFS. For a 4096 byte block size, it is currently parameter- 
ized for a maximum of two million cylinders. 


Per cylinder group information is summarized in blocks allocated from the 
first cylinder group’s data blocks. These blocks are read in from fs_csadadr (size 
_ cssize) in addition to the super block. 


Note that sizeof (struct csum) must be a power of two in order for the “fs_cs” 
macro to work. 

Super block for a file system: The size of the rotational layout tables is limited 
by the fact that the super block is of size SBSIZE. The size of these tables is 
inversely proportional to the block size of the file system. The size of the 
tables is increased when sector sizes are not powers of two, as this increases 
the number of cylinders included before the rotational pattern repeats ( 
fs_cpc). The size of the rotational layout tables is derived from the number of 
bytes remaining in (struct fs). 

The number of blocks of data per cylinder group is limited by the fact that cyl- 
inder groups are at most one block. The inode and free block tables must fit 
into a single block after deductin gspace for the cylinder group structure 
(struct cg). 

Inode: The inode is the focus of all file activity in the file system. There isa 
unique inode allocated for each active file, each current directory, each 
mounted-on file, text file, and the root. An inode is ‘named’ by its 
devicefi-number pair. For further information, see the include file <sys /ufsi- 
node.h>. 
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NAME 


fspec — format specification in text files 


DESCRIPTION 


It is sometimes convenient to maintain text files on the operating system with 
non-standard tabs (tabs that are not set at every eighth column). Such files 
must generally be converted to a standard format, frequently by replacing all 
tabs with the appropriate number of spaces, before they can be processed by 
system commands. A format specification occurring in the first line of a text 
file specifies how tabs are to be expanded in the remainder of the file. 


A format specification consists of a sequence of parameters separated by 
blanks and surrounded by the brackets <: and :>. Each parameter consists of 
a keyletter, possibly followed immediately by a value. The following parame- 
ters are recognized: 


ttabs The t parameter specifies the tab settings for the file. The value 
of tabs must be one of the following: 
1. alist of column numbers separated by commas, indicating 
tabs set at the specified columns; 


2. a-—followed immediately by an integer n, indicating tabs at 
intervals of n columns; 


3. a-— followed by the name of a “canned” tab specification. 
Standard tabs are specified by t-8, which is equal to tl, 9, 17, 25, 
and so forth. Canned tabs that are recognized are defined by the 
tabs(1) command. 


ssize The s parameter specifies a maximum line size. The value of size 
must be an integer. Size checking is performed after tabs have 
been expanded, but before the margin is prepended. 

margin 
The m parameter specifies a number of spaces to be prepended to 
each line. The value of margin must be an integer. 

d The d parameter takes no arguments. Its presence indicates that 
the line containing the format specification is to be deleted from 
the converted file. 

e The e parameter takes no arguments. Its presence indicates that 
the current format is to prevail only until another format specifi- 
cation is encountered in the file. 

Default values, which are assumed for parameters not supplied, are t-8 and 
m0. If the s parameter is not specified, no size checking is performed. If the 
first line of a file does not contain a format specification, the above defaults 
are assumed for the entire file. The following is an example of a line contain- 
ing a format specification: 

* <:t5,10,15 s72:> * 
If a format specification can be disguised as a comment, it is not necessary to 
code the d parameter. 


SEE ALSO 
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ed(1), newform(1), tabs(1) 
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NAME 


fstab — file-system-table 


© DESCRIPTION 
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The /etc/fstab file contains information about file systems for use by 
mount(1M) and mountall(1M). Each entry in /etc/fstab has the following 
format. The mnt_* names refer to the mnitent structure used by 
getmntent(3SEQ). 


column 1 mnt_fsname block special file name of file 
system or remote resource 


column 2 mnt_dir mount-point directory 

column 3 mnt_type file system type string 

column 4 mnt_opts options (comma separated no white space) 
column 5+ ignored 


White-space separates columns. Lines beginning with # are comments and 
empty lines are ignored. 


The file system type string (column 3) determines how the file system and 
options fields (columns 1 and 4) are interpreted. A list of the filesystem types 
currently supported follows, including the way each type interprets these 
fields: 


4.2—mnt_fsname (column 1) must be a block special device. 


ignore — The entire entry is ignored. This is useful to show disk par- 
titions not currently used. 


The options field (column 4) contains a list of comma-separated option words. 
Some option words are valid for all filesystem types, while others apply to a 
specific type only. 


Option words valid on all file systems are as follows: 
rw — read/write 
ro — read-only ; 
Note that either rw or ro (but not both) must be specified. 
Option words specific to 4.2 file systems are as follows: 
quota — usage limits enforced 
noquota — usage limits not enforced 
A file-system-table might read: 


/dev/dsk/zd0sO / 4.2 rw 
/dev/dsk/zd0s7 /usr 4.2 xrw,quota 
/dev/dsk/zdls7? /usr/src 4.2 ro 


The order of records in /etc/fstab is important because mountall(1M) 
processes the file sequentially; filesystems must appear after filesystems 
within which they are mounted. 


The entries from this file are accessed using the routines in 
getmntent(3SEQ). 
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FILES 
/etc/fstab 


SEE ALSO 
mount(1M), mountall(1M), mnttab(4), getmntent(3SEQ) 
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GETTYDEFS(4) 


gettydefs — speed and terminal settings used by getty 
DESCRIPTION 
The /etc/gettydefs file contains information used by getty(1M) to set up the 
speed and terminal settings for a line. It supplies information on what the 
login(1) prompt should look like. It also supplies the speed to try next if the 
user indicates the current speed is not correct by typing a break character. 
Each entry in /etc/gettydefs has the following format: 

label# initial-flags # final-flags # login-prompt #next-label 
Each entry is followed by a blank line. The various fields can contain quoted 


characters of the form \b, \n, \c, and so on, as well as \nnn, where nnn is the 
octal value of the desired character. The various fields are as follows: 


label 


initial-flags 


final-flags 


login-prompt 


next-label 


This is the string against which getty(1M) tries to match its 
second argument. It is often the speed (baud rate), such as 
1200, at which the terminal is supposed to run, but it need not 
be (see below). 


These flags are the initial ioctl(2) settings to which the termi- 
nal is to be set if a terminal type is not specified to getty(1M). 
The flags that getty(1M) understands are the same as the ones 
listed in /usr/include/sys/termio.h (see termio(7)). Normally 
only the speed flag is required in the initial-flags. getty(1M) 
automatically sets the terminal to raw input mode and takes 
care of most of the other flags. The initial-flag settings remain 
in effect until getty(1M) executes login(1). 


These flags take the same values as the initial-flags and are set 
just before getty(1M) executes login(1). The speed flag is again 
required. The composite flag SANE takes care of most of the 
other flags that need to be set so that the processor and termi- 
nal are communicating in a rational fashion. The other two 
commonly specified final-flags are TAB3, so that tabs are sent 
to the terminal as spaces, and HUPCL, so that the line is hung 
up on the final close. 


This entire field is printed as the login-prompt. Unlike the 
above fields where white space is ignored (a space, tab or new- 
line), they are included in the login-prompt field. 


If this entry does not specify the desired speed, indicated by the 
user typing a break character, then getty(1M) searches for the 
entry with next-label as its label field and set up the terminal 
for those settings. Usually, a series of speeds are linked 
together in this fashion into a closed set; for instance, 2400 
linked to 1200, which in turn is linked to 300, which finally is 
linked to 2400. 


If getty(1M) is called without a second argument, then the first entry of 
/ete/gettydefs is used, thus making the first entry of /etc/gettydefs the default 
entry. It is also used if getty(1M) can not find the specified label. If /etc/get- 
tydefs itself is missing, there is one entry built into getty(1M) which brings up 
a terminal at 300 baud. 
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It is strongly recommended that after making or modifying /etc/gettydefs, it 
be run through getty(1M) with the check option to be sure there are no errors. 


FILES 
/etc/gettydefs 


SEE ALSO 
login(1), stty(1), getty(1M), ioctl(2), termio(7) 

WARNINGS 
To support terminals that pass 8 bits to the system modify the entries in the 
/etc/gettydefs file for those terminals by adding CS8 to initial-flags and 
replacing all occurrences of SANE with these values: BRKINT IGNPAR 
ICRNL IXON OPOST ONCLR CS8 ISIG ICANON ECHO ECHOK 


An example of changing an entry in /etc/gettydefs is illustrated below. All the 
information for an entry must be on one line in the file. 
Original entry: 
CONSOLE # B9600 HUPCL OPOST ONLCR # B9600 SANE IXANY 
TAB3 HUPCL # Console Login: # console 


Modified entry: 
CONSOLE # B9600 CS8 HUPCL OPOST ONLCR # B9600 BRKINT 
IGNPAR ICNRL IXON OPOST ONLCR CS8 ISIG ICANON ECHO 
ECHOK IXANY TAB3 HUPCL # Console Login: # console 


This change permits terminals to pass 8 bits to the system so long as the sys- 
tem is in multi-user state. When the system changes to single-user state, 
getty(1M) is killed and the terminal attributes are lost. Therefore to permit a 
terminal to pass 8 bits to the system in single-user state after entering single- 
user state, enter the following (see stty(1)): 


stty -istrip ce8 


NOTES 
Customers who need to support terminals that pass 8 bits to the system (typi- 
cal outside the U.S.A.) must modify the entries in /etc/gettydefs as described 
in the WARNINGS section. 


BUGS 
8-bit with parity mode is not supported. 
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NAME 


gps — graphical primitive string, format of graphical files 


@ DESCRIPTION 


A graphical primitive string (GPS) is a format used to store graphical data. 
Several routines have been developed to edit and display GPS files on various 
devices. Also, higher level graphics programs such as plot (in stat(1G)) and 
vtoc (in toc(1G)) produce GPS format output files. 


GPS Primitives 
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AGPS is composed of five types of graphical data or primitives as follows: 


lines The lines primitive has a variable number of points from which 
zero or more connected line segments are produced. The first point 
given produces a move to that location. (A move is a relocation of 
the graphic cursor without drawing.) Successive points produce 
line segments from the previous point. Parameters are available to 
set color, weight, and style (see below). 


are The arc primitive has a variable number of points to which a curve 
is fit. The first point produces a move to that point. If only two 
points are included, a line connecting the points will result; if three 
points are included, a circular arc through the points is drawn; and 
if more than three points are included, lines connect the points. (In 
the future, a spline will be fit to the points if they number greater 
than three.) Parameters are available to set color, weight, and 
style. 


text The text primitive draws characters. It requires a single point 
which locates the center of the first character to be drawn. Param- 
eters are color, font, textsize, and textangle. 


hardware 
The hardware primitive draws hardware characters or gives con- 
trol commands to a hardware device. A single point locates the 
beginning location of the hardware string. 


comment 
Acomment is an integer string that is included in a GPS file but 
causes nothing to be displayed. All GPS files begin with a comment 
of zero length. 


GPS primitives are organized internally as follows: 
lines cw points sw 


arc cw points sw 
text cw point sw so [string] 
hardware 
cw point [string] 
comment 
cw [string] 
cw cw is the control word and begins all primitives. It consists of four 


bits that contain a primitive-type code and twelve bits that contain 
the word-count for that primitive. 
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point(s) point(s) is one or more pairs of integer coordinates. text and hard- 
ware primitives only require a single point. point(s ) are values 
within a Cartesian plane or universe having 64K (-32K to +32K) 
points on each axis. 

sw sw is the style-word and is used in lines, arc, and text primitives. 
For all three, eight bits contain color information. In arc and lines, 
eight bits are divided as four bits weight and four bits style. In the 
text primitive, eight bits of sw contain the font. 

80 so is the size-orientation word used in text primitives. Eight bits 
contain text size and eight bits contain text rotation. 

string _ string is a null-terminated character string. If the string does not 
end on a word boundary, an additional null is added to the GPS file 
to insure word-boundary alignment. 


GPS Parameters 
The GPS parameters are as follows: 


color color is an integer value set for arc, lines, and text primitives. 

weight weight is an integer value set for arc and lines primitives to indi- 
cate line thickness. The value 0 is narrow weight, lis bold, and 2 
is medium weight. 

style style is an integer value set for lines and arc primitives to give one 
of the five different line styles that can be drawn on TEKTRONIX 
4010 series storage tubes. They are: 


0. solid 
1 dotted 
2 dot dashed 
3 dashed 
4 long dashed 
font An integer value set for text primitives to designate the text font to 


be used in drawing a character string. (Currently font is expressed 
as a four-bit weight value followed by a four-bit style value.) 


textsize textsize is an integer value used in text primitives to express the 
size of the characters to be drawn. textsize represents the height of 
characters in absolute universe-units and is stored at one-fifth this 
value in the size-orientation (so) word (see below). 


textangle 
textangle is a signed integer value used in text primitives to express 
rotation of the character string around the beginning point. textan- 
gle is expressed in degrees from the positive x-axis and can be a 
positive or negative value. It is stored in the size-orientation (so) 
word as a value 256/360 of its absolute value. 


SEE ALSO 
graphica(1G), stat(1G), toc(1G) 
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NAME 


G& group — group file 
DESCRIPTION 


group is an ASCII file containing the following information fields for each 
group: 

group name 

encrypted password 

numerical group ID 

comma-separated list of all users allowed in the group 
The fields are separated by colons; each group is separated from the next by a 
new-line. If the password field is NULL, no password is required. 
The group file resides in /etc. Because the passwords are encrypted, the file 
has general read permission and, as an example, can be used to map numeri- 
cal group ID’s to names. 


FILES 
/ete/group 


SEE ALSO 
passwd(1), passwd(4), newgrp(1M) 
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NAME 
@ _helplog — monitor help actions 

DESCRIPTION 
The /usr/lib/help/HELPLOG file contains a history of all actions taken by 
the /usr/bin/help command, if help monitoring has been enabled. The 
HELPLOG file is copied to /usr/lib/help /oHELPLOG and a new 
/usr/lib/ help /HELPLOG file is created by the /usr/lib/help/helpclean com- 
mand. Executing helpclean twice in succession zeros out the HELPLOG and 
the oHELPLOG files. Note that /etc/cron, /etc/rc0, or /ete/re2 can be used to 
clean up the HELPLOG file. To use one of these functions, add the appropri- 
ate command line to the /usr/spool/cron/crontab/root, /etc/shutdown.d/..., 
or /etc/re.d/ re2.d, rc3.d ... file, as applicable. The following command lines 
limit the size of the log file to the last 100 lines in the file: 


tail -100 /usr/lib/help/HELPLOG > /tmp/help 
mv /tmp/help /usr/lib/help/HELPLOG 


EXAMPLES 
The following display shows a typical /usr/lib/help/HELPLOG file: 
login=bin uname=wr3b2a date=Mon Aug 20 12:51:03 EDT 1984 
name=locate response=' 1’ status=0K 
name=locate response=' d’ status=ERROR 
name=getkey response='k!’ status=OK 
name=keysrch response=’ list’ status=OK 
eS name=quit response='q’‘ status=OK 

login=bin uname=wr3b2a date=Mon Aug 20 12:51:41 EDT 1984 

SEE ALSO 


cron(1M), re(4) 
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NAME 
init.d — system level transition files directory 


DESCRIPTION 
The /etc/init.d directory contains executable files used in upward and down- 
ward transitions to all system run levels. These files are linked to files begin- 
ning with S (start) or K (stop) in /etc/ren.d, where n is the appropriate run 
level. Files are not executed from this directory; they are only executed from 
/etc/ren.d directories. 


SEE ALSO 
re(4) 
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NAME 


inittab — script for the init process 


@ DESCRIPTION 


The inittab file supplies the script to init(1M)’s role as a general process dis- 
patcher. The process that constitutes the majority of init’s process dispatch- 
ing activities is the line process /etc/getty that initiates individual terminal 
lines. Other processes typically dispatched by init are daemons and the shell. 


The inittab file is composed of entries that are position dependent and have 
the following format: 


id:rstate:action:process 


Each entry is delimited by a newline; a backslash (\) preceding a newline 
indicates a continuation of the entry. Up to 512 characters per entry are per- 
mitted. Comments may be inserted in the process field using the sh(1) con- 
vention for comments. Comments for lines that spawn gettys are displayed 
by the who(1) command. It is expected that they will contain some informa- 
tion about the line such as the location. There are no limits (other than maxi- 
mum entry size) imposed on the number of entries within the inittab file. 
The entry fields are as follows: 


id One to four characters used to uniquely identify an entry. Four char- 
acter sequences are used for tty entries and should be avoided for 
other types of entries. 


rstate The run-level in which this entry is to be processed. run-levels 
effectively correspond to a configuration of processes in the system. 
That is, each process spawned by init is assigned a run-level or 
run-levels in which it is allowed to exist. The run-levels are repre- 
sented either by a number ranging from 0 through 6 or by the letters 
sor S (identical specifiers for single-user level). For a definition of 
each run-level , see init (1M). 


As an example, if the system is in run-level 1, only those entries 
having a 1 in the rstate field will be processed. When init is 
requested to change run-levels, all processes which do not have an 
entry in the rstate field for the target run-level are sent the warn- 
ing signal (SIGTERM) and allowed a 20-second grace period before 
being forcibly terminated by a kill signal (SIGKILL). The rstate 
field can define multiple run-levels for a process by selecting more 
than one run-level in any combination from 0-6. If no run-level is 
specified, then the process is assumed to be valid at all run-levels 
0-6. 


The level s (or S) can be used only with the initdefault, powerfail, 
powerwait and powerokwait action fields. Lines in inittab that con- 
tain s (or S) and do not have one of the above action fields will be 
ignored. 

There are three other values, a, b and c, which can appear in the 
rstate field, even though they are not true run-levels. Entries 
which have these characters in the rstate field are processed only 
when the telinit (see init(1M)) process requests them to be run 


INITTAB(4) 


action 


DYNIX/ptx 


(regardless of the current run-level of the system). These entries 
differ from run-levels in that init can never enter run-level a, b or 
c. Also, a request for the execution of any of these processes does not 
change the current run-level. Furthermore, a process started by an 
a, b or c command is not killed when init changes levels. They are 
only killed if their line in /etc/inittab is marked off in the action 
field, their line is deleted entirely from /etc/inittab, or init goes into 
the single-user state. 


Key words in this field tell init how to treat the process specified in 
the process field. The actions recognized by init are as follows: 


respawn 


wait 


once 


boot 


bootwait 


powerfail 


powerwait 


If the process does not exist, start the process; do not 
wait for its termination (continue scanning the inittab 
file), and when it dies restart the process. If the process 
currently exists, do nothing and continue scanning the 
inittab file. 


Upon init’s entering the run-level that matches the 
entry’s rstate, start the process and wait for its termi- 
nation. All subsequent reads of the inittab file while 
init is in the same run-level cause init to ignore this 
entry. 

Upon init’s entering a run-level that matches the 
entry’s rstate, start the process; do not wait for its ter- 
mination. When it dies, do not restart the process. If 
upon entering a new run-level, where the process is 
still running from a previous run-level change, the 
program is not restarted. 


The entry is to be processed only at init’s boot-time 
read of the inittab file. init is to start the process, not 
wait for its termination; and when it dies, not restart 
the process. In order for this instruction to be mean- 
ingful, the rstate should be the default or it must 
match init’s run-level at boot time. This action is use- 
ful for an initialization function following a hardware 
reboot of the system. 


The entry is to be processed the first time init goes 
from single-user to multi-user state after the system is 
booted. (If initdefault is set to 2, the process runs 
right after the boot.) init starts the process, waits for 
its termination and, when it dies, does not restart the 
process. 


Execute the process associated with this entry only . 
when init receives a power-fail signal (SIGPWR) with a 
signal code value of PWR_FAIL. Refer to signal(2) and 
sigcontext(2seq). This action functions only on SSM- 
based systems. 


Execute the process associated with this entry only 
when init receives a power fail signal (SIGPWR) with a 
signal code value of PWR_FALL, and wait until it 
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terminates before continuing any processing of inittab. 
S This action functions only on SSM-based systems. 


powerokwait 
Execute the process associated with this entry only 
when init receives a power fail signal (SIGPWR) with a 
signal code value of PWR_OK, and wait until it termi- 
nates before continuing any processing of inittab. This 
action functions only on SSM-based systems. 


off If the process associated with this entry is currently 
running, send the warning signal (SIGTERM) and wait 
20 seconds before forcibly terminating the process with 
the kill signal (SIGKILL). If the process is nonexistent, 
ignore the entry. 


ondemand This instruction is really a synonym for the respawn 
action. It is functionally identical to respawn but is 
given a different keyword in order to divorce its associ- 
ation with run-levels. This is used only with the a, b 
or c values as described for the rstate field. 


initdefault An entry with this action is only scanned when init is 
initially invoked. init uses this entry, if it exists, to 
determine which run-level to enter initially. It does 
this by taking the highest run-level specified in the 
rstate field and using that as its initial state. If the 

@ rstate field is empty, this is interpreted as 0123456, 

and so init will enter run-level 6. Additionally, if init 
does not find an initdefault entry in /etc/inittab, it 
requests an initial run-level from the user at reboot 
time. 

sysinit Entries of this type are executed before init tries to 
access the console (i.e., before the Console Login: 
prompt). It is expected that this entry will be only used 
to initialize devices on which init might try to ask the 
run-level question. These entries are executed and 
waited for before continuing. 


process Ash command to be executed. The entire process 
field is prefixed with exec and passed to a forked sh as 
sh -c ‘exec command’. For this reason, any legal sh 
syntax can appear in the process field. Comments can 
be inserted with the ; #comment syntax. 


FILES 
/etc/inittab 


SEE ALSO 
sh(1), who(1), getty(1M), init(1M) exec(2), open(2), signal(2) 
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NAME 
issue — issue identification file 

DESCRIPTION 
The file /etc/issue contains the issue or project identification to be printed as 
a login prompt. This is an ASCII file which is read by program getty and then 
written to any terminal spawned or respawned from the lines file. 


FILES 
/etc/issue 


SEE ALSO 
login(1) 
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NAME 


ldfcn — common object file access routines 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <ldfcn.h> 


DESCRIPTION 
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The common object file access routines are a collection of functions for reading 

common object files and archives containing common object files. Although 

the calling program must know the detailed structure of the parts of the object 

file that it processes, the routines insulate the calling program from knowl- 

edge of the overall structure of the object file. 

The interface between the calling program and the object file access routines 

is based on the defined type LDFILE , defined as struct Idfile, declared in the 

header file </dfcn.h>. The primary purpose of this structure is to provide uni- 

form access to both simple object files and to object files that are members of 

an archive file. 

The function Idopen(3X) allocates and initializes the LDFILE structure and 

returns a pointer to the structure to the calling program. The fields of the 

LDFILE structure may be accessed individually through macros defined in 

<ldfcn.h> and contain the following information: 

LDFILE *ldptr; 

TYPE(dptr) The file magic number used to distinguish between 
archive members and simple object files. 

IOPTR(idptr) The file pointer returned by fopen and used by the stan- 
dard input-output functions. 

OFFSET(Idptr) The file address of the beginning of the object file; the off- 
set is non-zero if the object file is a member of an archive 
file. 


HEADER(Idptr) The file header structure of the object file. 


The object file access functions themselves may be divided into four categories: 
(1) Functions that open or close an object file 


Idopen(3X) and Idaopen{see Idopen(3X)] 
open a common object file 


Idclose(3X) and Idaclose[see ldclose(3X)] 
close a common object file 


(2) Functions that read header or symbol table information 


Idahread(3X) 
read the archive header of a member of an archive file 


ldfhread(3X) 
read the file header of a common object file 
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Idshread(3X) and ldnshread[see Idshread(3X)] 
read a section header of a common object file 


Idtbread(3X) 
read a symbol table entry of a common object file 


Idgetname(3X) 
retrieve a symbol name from a symbol table entry or 
from the string table 


(3) Functions that position an object file at (seek to) the start of the 
section, relocation, or line number information for a particular section. 


ldohseek(3X) 
seek to the optional file header of a common object file 


ldsseek(3X) and ldnsseek[see Idsseek(3X)] 
seek to a section of a common object file 


ldrseek(3X) and ldnrseek[see Idrseek(3X)] 
seek to the relocation information for a section of a 
common object file 


Idlseek(3X) and Idnlseek[see Ildlseek(3X)] 
seek to the line number information for a section of a 
common object file 


ldtbseek(3X) 
seek to the symbol table of a common object file 


(4) the function lIdtbindex(3X) which returns the index of a particular 
common object file symbol table entry. 


These functions are described in detail on their respective manual pages. 


All the functions except Idopen(3X), Idgetname(3X), ldtbindex(3X) return 
either SUCCESS or FAILURE, both constants defined in </dfen.h>. Both ldo- 
pen(3X) and Idaopen (see Idopen (3X)) return pointers to an LDFILE struc- 
ture. 


Additional access to an object file is provided through a set of macros defined 
in <ldfcn.h>. These macros parallel the standard input-output file reading 
and manipulating functions, translating a reference of the LDFILE structure 
into a reference to its file descriptor field. 


The following macros are provided: 
GETC(idptr) 


FGETC(dptr) 
GETW(dptr) 


UNGETC(e, ldptr) 
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FGETS(s, n, Idptr) 

FREAD((char *) ptr, sizeof (*ptr), nitems, ldptr) 
FSEEK(dptr, offset, ptrname) 

FTELL(dptr) 

REWIND(idptr) 

FEOF(dptr) 

FERROR(dptr) 

FILENO(dptr) 

SETBUF(ldptr, buf) 


STROFFSET(dptr) 
The STROFFSET macro calculates the address of the string table. See the 
manual entries for the corresponding standard input-output library functions 
for details on the use of the rest of the macros. 
The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 
fseek(3S), ldahread(3X), ldclose(3X), ldgetname(3X), ldfhread(3X), ldlread(3X), 
Idlseek(3X), ldohseek(3X), ldopen(3X), ldrseek(3X), ldsseek(3X), ldshread(3X), 
ldtbindex(8X), ldtbread(3X), ldtbseek(3X), stdio(3S), intro(5) 
WARNINGS 
The macro FSEEK defined in the header file </dfcn.h> translates into a call to 
the standard input/output function fseek(3S). FSEEK should not be used to 


seek from the end of an archive file since the end of an archive file may not be 
the same as the end of one of its object file members. 
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NAME 
limits — file header for implementation-specific constants 


SYNOPSIS 
#include <limits.h> 


DESCRIPTION 
The header file <limits.h> is a list of magnitude limitations imposed by a spe- 
cific implementation of the operating system. All values are specified in deci- 
mal. 


#define NGROUPS MAX 16 /* # supplimentary GIDs per process x/ 
#define ARG MAX 12288/* max length of arguments to exec x/ 
#define MAX_CANON 256 /* sizeof cononical input queue */ 
#define MAX_INPUT 256 /* # of bytes of atomic tty input */ 
#define CHAR BIT 8 /* # of bits in a "char" */ 
#define CHAR_MAX 127 /* max integer value of a "char" */ 
#define CHAR_MIN -128 /* min integer value of "char" */ 
#define SCHAR_MIN -128 /* min integer value of a signed char */ 
#define SCHAR MAX 127 /* max integer value of a signed char */ 
#idefine UCHAR_MAX 255 /* max integer value of an unsigned char ¥/ 
#define CHILD_MAX 100 /* max # of processes per user ID */ 
#define CLK_TCK 100 /* # of clock ticks per second */ 
#define DBL_DIG 15 /* digits of precision of a "double" */ 
#define DBL_MAX 1.79769313486231470e+308 

/*max decimal value of a "double" */ 
#define DBL_MIN 4.94065645841246544e-324 

/*min decimal value of a "double™ */ 
#define FCHR_MAX 1048576 

/* max size of a file in bytes */ 
#define FLT_DIG 7 /* digits of precision of a "float" */ 
#define FLT_MAX 3.40282346638528860e+38 

/*max decimal value of a "float" */ 
#define FLT MIN 1.40129846432481707e-45 

/*min decimal value of a "float" */ 
#tdefine HUGE_VAL 3.40282346638528860e+38 

/*error value returned by Math lib */ 
#define INT_MAX 2147483647 

/* max decimal value of an "int" */ 
#define INT_MIN -2147483648 

/* min decimal value of an "int" */ 
#define UINT_MAX 4294967295 

/* max decimal value of an unsigned int */ 
#define ULONG_MAX 4294967295 

/* max decimal value of an unsigned long */ 
#define USHRT_MAX 65535 

/* max decimal value of an unsigned short */ 


a 
a 
a 
a 


#define LINK_MAX 1000 

/* max # of links to a single file */ 
#define LONG MAX 2147483647 

/* max decimal value of a "long" */ 
#define LONG MIN -2147483648 
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/* min decimal value of a "long" */ 
#define MB_LEN MAX 1 /* max bytes in a multibyte char */ 
#define NAME MAX 255 /* max # of characters in a filename */ 
#define OPEN MAX 20 /* max # of files a process can have open */ 
#define PASS MAX 8 /* max # of characters in a password */ 
#define PATH MAX 1023 /* max # of characters in a pathname */ 
#define PID MAX 30000 /* max value for a process ID */ 
#define PIPE BUF 8192 /* max # bytes atomic in write to a pipe */ 
#define PIPE MAX 8192 /* max # bytes written to a pipe in a write */ 
#define SHRT MAX 32767/* max decimal value of a "short" */ 
#define SHRT_MIN -32768 

/* min decimal value of a "short" */ 
#define STD_BLK 2048 /* # bytes in a physical I/O block */ 
#define SYS _NMLN 9 /* # of chars in uname-returned strings */ 
#define UID_MAX 60000 /* max value for a user or group ID */ 
#define USI_MAX 4294967295 

/* max decimal value of an "unsigned" */ 
#define WORD BIT 32 /* # of bits in a "word" or "int" */ 
#define LONG BIT 32 /* # of bits in a long */ 
#define MAX_CHAR 256 /* max size of char input buffer */ 
#define SYSPID_MAX 30000 

/* max pid of system processes */ 
#define TMP_MAX 17576/* max # of unique tmpnam names */ 
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NAME 
linenum — line number entries in a common object file 
SYNOPSIS 
#include <linenum.h> 
* DESCRIPTION 


The cce(1) command, when invoked with the -g option, generates an entry in 
the object file for each C source line on which a breakpoint is possible. Users 
can then reference line numbers when using the appropriate software test sys- 
tem (see pdbx(1)). The structure of these line number entries is as follows: 


struct lineno 
{ 
union 
{ 
long 1_symndx ; 
long 1 _paddr ; 
} l_addr ; 
unsigned short1l_lnno ; 
de 
Numbering starts with one for each function. The initial line number entry 
for a function has |Inno equal to zero, and the symbol table index of the func- 
tion’s entry is in | symndx. Otherwise, ]_Inno is non-zero, and l_paddr is 
the physical address of the code for the referenced line. Thus the overall 
structure is as follows: 


Laddr Linno 
function symtabindex 0 
physical address line 


physical address line 


function symtabindex 0 
physical address line 
physical address line 


SEE ALSO 
ec(1), pdbx(1), a.out(4) 
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NAME 
& /usr/adm/loginlog — log of failed login attempts 
DESCRIPTION 


After five unsuccessful login attempts, all attempts are logged in the loginlog 
file. This file contains one record for each failed attempt. Each record con- 
tains the following information: 


login name 

tty specification 

time 
This is an ASCII file. Each entry is separated from the next by a new-line. 
Fields within each entry are colon-separated. 


By default, loginlog does not exist, so no logging is done. To enable logging, 
the log file must be created with read and write permission for owner only. 
The owner must be root and the group must be sys. 


FILES 
/usr/adm/loginlog 


SEE ALSO 
login(1), passwd(1) 
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NAME 
Iptypes — table of printer types supported by the menu system 
DESCRIPTION 
The Iptypes table contains a list of printer types that the Add a Printer com- 
mand (Ipadmadd) accepts. 
FIELDS 
Model Interface File Name 
This is the name of the model interface file that should be substituted into the 
lpadmin command’s -m option when the user selects the corresponding 
printer description. This file name must be executable and must exist in the 
/usr/ spool / lp / model directory. 
Printer Description 
This is the description of the printer type described by the model interface file. 
In most cases users are unable to understand the entries in the model inter- 
face file. This is a required field. 
FILES 
&(TFADMFILE}/etc/Iptypes Table of printer types supported by the menu sys- 
tem 


NOTES 
Only the superuser (root) can update this file. All users can read this file. 
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NAME 


mnttab — mounted filesystem table 


& DESCRIPTION 


FILES 


mnttab resides in directory /etc and contains a table of filesystems currently 
mounted by the mount(1M) command. The umount(1M) command removes 
entries from this file. 


The file contains a line of information for each mounted filesystem, structu- 
rally identical to the contents of /etc/fstab as described in fstab(4), with the 
exception that columns 5 and beyond are replaced with a number representing 
the time (as returned by time(2)) when the filesystem was mounted. 


The entries from the mnttab file are accessed using the routines in 
getmntent(3SEQ) or printed via mount(1M). 


/etc/mnttab 


SEE ALSO 
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mount(1M), setmnt(1M), umount(1M) getmntent(3SEQ), fatab(4) 


DYNIX/ptx 


NAME 


MOD_CONFIG(4) 


@ mod_config — format of a module configuration file 
DESCRIPTION 


A mod_config file exists for each module in a kernel configuration file tree. 
The file describes what the module is and what other files are needed to gener- 
ate the module. The directives below can appear in any order, with the excep- 
tion of the checkfor directive which must appear as the first directive in a 
module configuration file when specified. Options can appear as a single 
quantity prepended with an equal sign, as a comma-separated list enclosed in 
parentheses, or as a line-delimited list enclosed in braces. Comments can 
appear preceded with a pound (#) sign. The directives are as follows: 


Directive 


checkfor { options } 


block { option } 
character { option } 
streamd { option } 
streamm 
pseudo_device 
filesystem { option } 
bus { options } 
prefix { option } 
maxpsuedos { option } 
maxunit { option } 
minunit { option } 


ifTYPE ( parameter ) { 


{ statements } 
} elsifTYPE ( parameter ) { 


{ statements } 
} else [ 

{ statements } 
} 


on_bus { options } 
syscalls { option ) 


inits { options } 
functions { options } 
headers { options } 


Description 


The named modules must be parsed 
before this one 


Block device major device number 
Character device major device number 
Stream driver major device number 
Stream module 

Pseudo-device 

File system type number 

This module provides these busses 
Use this as the name prefix 
Maximum number of psuedos 
Maximum permitted unit number 
Minimum permitted unit number 


Conditional ifTYPE (e.g. ifdef) 

TYPE is one of: config, -nconfig, def, ndef, 
product, nproduct. 

- true clause 

Optional else ifTYPE (e.g. elsifdef) 

TYPE is one of: config, nconfig, def, ndef, 
product, nproduct. 

- true clause 

Optional else 

- false clause 


The module lives on these busses 
This module provides this system 
call table 

Declare these initialization functions 
Declare these device driver functions 
List of header files for this module 
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modules { options } List of c and assembler files 

space { options } List of space files 

makeopts { options } Makefile options 

conf { options } conf.c options 

confh { options } config.h options 

print { option } Print argument 

fatal { option } Print argument and abort configuration 
trace Trace toggle 

NEXT { option } Next module definition 

declare [ level] {params} Declare configurable parameters 
default { defaults } Define default parameter values 
new_default { defaults } Define new default parameter values 
adjust { param_exprs } Adjust parameter values 

set { param_exprs } Set parameter values 

bound { bound_exprs } Bound parameter values 

assert { assertions } Assert parameter values 


The directive modifiers are as follows: 


Modifier Description 
level Defines parameter visibility level [1..10] 
params List of parameters in the form: 
name type { "description" } 
defaults List of default parameter values: 
name { expr } 
name { expr ; bound } 


param_exprs List of expressions adjusting or setting 
parameter values: 


name { expr } 

bound_exprs _ List of parameter bound expressions: 
name { bound } 

assertions List of parameter value assertions: 
{expr relop expr ; "assert text"} 

bound Bound interval for parameter: 


low_bound_expr .. 

» high_bound_expr 

low_bound_expr .. high_bound_expr 
expr A simple arithmetic expression 
relop Arelational operator: <= < = > >= 
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EXAMPLES 


prefix="ex" 
block=7 
functions{"_init"} 


space {ex_space.c} 


modules { 
ixtr ic 
iytr.c 
} 
SEE ALSO 


config (1m), sys_config (4) 
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NAME 
© motd — message-of-the-day file 


DESCRIPTION 
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The /etc/motd file contains the message-of-the-day. The message-of-the-day 
is displayed on your terminal by /etc/ profile after a successful login. This 
message should be kept short and to the point. The /usr/news files should be 
used for lengthy, more explicit messages. 
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NAME 


ott — files that hold object architecture information 


@ DESCRIPTION 


© FILES 
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The FACE object architecture stores information about object types in an 
ASCII file named .ott (object type table) that is contained in each directory. 
This file describes all of the objects in that directory. 


Each line of the .ott file contains information about one object in pipe- 
separated fields. The fields are in the following order: 


name The name of the actual system file. 


dname The name that should be displayed to the user, or a dot ifit is 
the same as the name of the file. 


description The description of the object, or a dot if the description is the 
default (the same as object-type). 


object-type The FACE internal object type name. 
flags Object specific flags. 
mod time The time that FACE last modified the object. The time is given 


as number of seconds since 1/1/1970, and is in hexadecimal 
notation. 


object information 
An optional field, contains a set of semi-colon separated 
“name=value” fields that can be used by FACE to store any 
other information necessary to describe this object. 


ott created in any directory opened by FACE. 
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passwd — password file 


DESCRIPTION 
The /etc/passwd file identifes each user to the system. Entries are added for 
each new user. The passwd file is an ASCII file. Because user passwords are 
encrypted, the file has general read permission; therefore it can be used, for 
example, to map numerical user IDs to names. Entries for each user are 
separated by newlines. Fields within each user entry are separated by colons. 
/etc/passwd contains the following information for each user: 


login name:passwd:user:group:account:login directory:program 


Explanations for these fields are as follows: 


login name 


passwd 


The first field defines the login name. The login name is from 
three to six characters long. The first character is alphabetic. 
The rest of the characters are alphanumeric. No uppercase 
characters are allowed. 


The password field consists of either an encrypted password, or 
the character x if there is an /etc/shadow file. If /etc/shadow 
does not exist, and the login does have a password, this field 
contains an encrypted copy of the password. This field remains 
only for compatibility reasons when /etc/shadow exists. 


An encrypted login password contains 13 bytes (characters). 
The encrypted password consists of 13 characters chosen from 
a 64-character alphabet (., /, 0-9, A-Z, a-z), except when the 
password is null, in which case the encrypted password is also 
null. The actual password is limited to a maximum of 8 bytes. 
The encrypted password can be followed by a comma and up to 
4 more bytes of password aging information. 


Password aging is in effect for a particular user if his 
encrypted password in the password file is followed by a 
comma and a non-null string of characters from the above 
alphabet. (Such a string must be introduced in the first 
instance by the superuser.) 


The first character of the age, M, for example, denotes the 
maximum number of weeks for which a password is valid. A 
user who attempts to login after his password has expired is 
forced to supply a new one. The next character, m, for 
example, denotes the minimum period in weeks which must 
expire before the password may be changed. The remaining 
one or two characters define the week (counted from the begin- 
ning of 1970) when the password was last changed. (A null 
string is equivalent to zero.) M and m have numerical values 
in the range 0-63 that correspond to the 64-character alphabet 
shown above (i.e.,/= 1 week; z = 63 weeks). If m =M =0 
(derived from the string . or ..), the user is forced to change his 
password the next time he logs in (and the age disappears from 
his entry in the password file). If m > M (signified, e.g., by the 
string /), only the superuser can change the password. 
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user id The third field contains the user identification number, which 
must be between 0 and 60,000. Group identification numbers 
0 through 99 are reserved; 0 indicates the superuser (root). 
Commas are not allowed in this field. 


group id The fourth field contains the group identification number, 
which must be between 0 and 60,000. Group identification 
numbers 0 through 99 are reserved; 0 indicates the superuser 
(root). Commas are not allowed in this field. 


account The fifth field is used by accounting programs. This field typi- 
cally contains the user name, department number, bin num- 
ber, or other miscellaneous information. 

login directory 
The sixth field defines the full pathname of the initial working 
directory (login directory). 

program The seventh field defines the program to be executed after 
login. If this field is empty, the shell (/bin/sh) is invoked. 


EXAMPLES 


FILES 


A typical portion of an /etc/passwd file follows: 


root::0:1:0000-Admin (0000) :/: 

daemon: NP:1:1:0000-Admin (0000) :/: 
bin:NP:2:2:0000-Admin (0000) :/bin: 
sys:NP:3:3:0000-Admin (0000) : /usr: 

adm: NP: 4:4:0000-Admin (0000) : /usr/adm: 
uucp:NP:5:5:0000-uucp (0000) :/usr/lib/uucp: 
nuucp:NP:10:10:0000-uucp (0000) : /usr/spool/uucppublic:/usr/lib 
sync: :67:1:0000-Admin (0000) :/:/bin/syne 

lp:NP:71:2:0000-1p(0000) :/usr/spool/1p: 

usrlimit:NP:88:4:1 user system (DON’T CHANGE THIS LINE):/:/dev/null 
setup::0:0:general system administration:/usr/admin:/usr/bin 
powerdown:NP:0:0:general system administration: /usr/admin 
sysadm:NP:0:0:general system administration: /usr/bin/sysadm 
bupsched:NP:0:0:administration login: /usr/admin: /usr/bin/bupsched 
checkfsys:NP:0:0:administration login: /usr/bin/checkfsys 

mount fsys:NP:0:0:administration login: /usr/admin: /usr/bin/mountfsys 
umount fsys:NP:0:0:administration login: /usr/bin/umount fsys 
vmsys:NP:4000:400:FACE usr login: /usr/vmsys: 
oasys:NP:4001:401:0bject Architecture Files:/usr/oasys: 
anneh:x:100:1:Anne Harris, Sales, 9238:/usr/anneh: 
bobs:x:101:1:Robert Smith, Engineering, 1234:/usr/bobs: 
coleenl:x:102:1:Coleen Laser:/usr/coleenl: 

dol:x:103:1:David Osborne: /usr/dol:/bin/ksh 


/etc/passwd 
/etc/shadow 


SEE ALSO 


login(1), passwd(1), passmgmt(1M), getpwent(3C), group(4), shadow(4) 
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NAME 


PLOT(4) 


i) plot — graphics interface 
DESCRIPTION 


Files of this format are produced by routines described in plot(3X) and are 
interpreted for various devices by commands described in tplot(1G). A graph- 
ics file is a stream of plotting instructions. Each instruction consists of an 
ASCII letter usually followed by bytes of binary information. The instructions 
are executed in order. A point is designated by four bytes representing the x 
and y values; each value is a signed integer. The last designated point in an 1, 
m, n, or p instruction becomes the “current point” for the next instruction. 


Each of the following descriptions begins with the name of the corresponding 
routine in plot(3X): 


m_ move: The next four bytes give a new current point. 


n 


Pp 
1 


cont: Draw a line from the current point to the point given by the 
next four bytes (see tplot(1G)). 


point: Plot the point given by the next four bytes. 


line: Draw a line from the point given by the next four bytes to the 
point given by the following four bytes. 


label: Place the following ASCII string so that its first character 
falls on the current point. The string is terminated by a new-line. 


erase: Start another frame of output. 


linemod: Take the following string, up to a new-line, as the style 
for drawing further lines. The styles are dotted, solid, long- 
dashed, shortdashed, and dotdashed. This is effective only for the 
-T4014 and -Tver options of tplot(1G) (TEKTRONIX 4014 termi- 
nal and Versatec plotter). 


space: The next four bytes give the lower left corner of the plot- 
ting area; the following four give the upper right corner. The plot 
will be magnified or reduced to fit the device as closely as possible. 


Space settings that exactly fill the plotting area with unity scaling 
appear below for devices supported by the filters of tplot(1G). The 
upper limit is just outside the plotting area. In every case the plotting 
area is taken to be square; points outside may be displayable on 
devices whose face is not square. 


SEE ALSO 


DASI 300 space(0, 0, 4096, 4096); 
DASI 300s space(0, 0, 4096, 4096); 
DASI 450 space(0, 0, 4096, 4096); 


TEKTRONIX 4014 space(0, 0, 3120, 3120); 
Versatec plotter space(0, 0, 2048, 2048); 


graph(1G), tplo(1G), plot(3X), gps(4), term(5) 


WARNING 


names erase() and move(). The curses versions are macros. If you need both 


@ The plotting library, plot(3X), and the curses library, curses(3X), both use the 


libraries, put the code in a different source file than the curses(3X) code, or 
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#undef move() and erase() in the plot(3X) code. 
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NAME 
product — installed products file 


DESCRIPTION 
This file contains a record of all software products that have been installed 
using the product installation routines. The information in the file is used by 
the routines that back up and remove software products. 


FIELDS 
Product Code 
This is the name of the product. When the installation procedure completes 
successfully, the system uses this name as a prefix for the file that is created: 
/ usr / options / prod.mnt531. This is a required field. 


Product Class 
This describes the type of product, such as Word Processor, Spreadsheet, or 
Database. You can sort the file by this field to list all products in a class. This 
is a required field. 


Product Description 
When the user selects the Run, Back up, or Remove options, this description 
appears in the SELECT window. This is a required field. 


Binary Home Directory 
The name of the parent directory where the product binaries are stored. This 
may be used by the product backup and/or removal routines. This is a 
required field. 


Data Home Directory 
The name of the parent directory that holds the product data. This may be 
used by the product backup and/or removal routines. This is a required field. 


Version Number 
This field holds the version number of the installed product. This is a required 
field. ; 

Program to invoke 
Name of the program that is initiated when the user selects this product from 
the Run Application SELECT window. This is a required field. 


FILES 
$(TFADMFILE)/etc/product Installed Products File 


NOTES 
This file is maintained by the System Administrator. If product installation 


and/or removal procedures are bypassed and products are added or removed 
manually, the information in this file may not be correct. 
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NAME 
& profile — setting up an environment at login time 


SYNOPSIS 
/etc/profile 
$HOME/. profile 


DESCRIPTION 
Users who have the shell sh(1) as their login command have the commands in 
/etc/ profile and $HOME/.profile executed as part of the login sequence. 


/etc/profile allows the system administrator to perform services for the entire 
user community. Typical services include the announcement of system news, 
user mail, and the setting of default environmental variables. It is not 
unusual for /etc/ profile to execute special actions for the root login or the 
su(1) command. Computers running outside the Eastern time zone should 
have the following line included early in /etc/ profile (see timezone(4)). 


. /etc/TIMEZONE 


The file $HOME/ profile is used for setting exported environment variables 
and terminal modes specific to each user. A typical example (except for the 
comments) of a of a user’s .profile file follows: 


# Make some environment variables global 
export MAIL PATH TERM 
# Set file creation mask 
umask 027 
# Tell me when new mail comes in 
@ MAIL=/usr/mail/$LOGNAME 
# Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME/bin 
# Set terminal type 


while : 
do echo "terminal: \c" 
read TERM 
if ( -f£ ${TERMINFO:-/usr/lib/terminfo}/?A4TERM ] 
then break 
elif [ -f /usr/lib/terminfo/?/STERM J 
then break 
else echo "invalid term $TERM" 1>&2 
fi 
done 


# Initialize the terminal and set tabs 

# The environmental variable TERM must have been exported 
# before the "tput init" command is executed. 

tput init 

# Set the erase character to backspace 

stty erase '“H’ echoe 


FILES 
/etc/TIMEZONE Timezone environment 
$HOME/. profile User-specific environment 
@ /etc/profile System-wide environment 
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SEE ALSO 
env(1), login(1), mail(1), sh(1), stty(1), su(1), tput(1), su(1M), terminfo(4), 
timezone(4), environ(5), term(5) 

NOTES 
Care must be taken in providing system-wide services in /etc/profile. Per- 
sonal .profile files are better for serving all but the most global needs. 
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NAME 


proto — prototype job file for at 


SYNOPSIS 


Ausr/lib/cron/.proto 
/usr/lib/.proto.queue 


DESCRIPTION 


When a job is submitted to at(1) or batch(1), the job is constructed as a shell 
script. First, a prologue is constructed, consisting of: 
¢ A header whether the job is an at job or a batch job (actually, at 
jobs submitted to all queues other than queue a, not just to the batch 
queue b, are listed as batch jobs); the header is 


: at job 
for an at job, and 
: batch job 
for a batch job. 


¢ Aset of Bourne shell commands to make the environment (see envi- 
ron(5)) for the at job the same as the current environment; 


¢ Acommand to run the user’s shell (as specified by the SHELL envi- 
ronment variable) with the rest of the job file as input. 


at then reads a prototype file, and constructs the rest of the job file from it. 


Text from the prototype file is copied to the job file, except for special variables 
that are replaced by other text: 


$d is replaced by the current working directory 
$1 is replaced by the current file size limit (see ulimit(2)) 
$m is replaced by the current umask (see umask(2)) 
$t is replaced by the time at which the job should be run, 
expressed as seconds since January 1, 1970, 00:00 Univeral 
Time Code (Greenwich Mean Time), preceded by a colon 
$< is replaced by text read by at from the standard input (that is, 
the commands provided to at to be run in the job) 
If the job is submitted in queue queue, at uses the file 
/asr/lib/cron/.proto queue as the prototype file if it exists, otherwise it will 
use the file (usr/lib/cron/.proto. 


EXAMPLES 
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The standard .proto file supplied is: 
#ident "@ (#)adm:.proto T532" 


cd $d 
ulimit $1 
umask $m 
S< 


which causes commands to change the current directory in the job to the cur- 
rent directory at the time at was run, to change the file size limit in the job to 
the file size limit at the time at was run, and to change the umask in the job 
to the umask at the time at was run, to be inserted before the commands in 


PROTO(4) 


the job. 


FILES 
/usr/lib/cron/.proto 
/usr/ib/cron/.proto.queue 


SEE ALSO 
at (1) 
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NAME 


re — reboot and shutdown command scripts 


DESCRIPTION 


The following files and directories are described here: 
lete/rcO 

/ete/rc0.d 

lete/re2 

/ete/re2.d 

lete/re.d 

lete/re8 


/ete/rc0 File 


The /etc/rc0 file contains a shell script that is executed by shutdown for 
transitions to single-user state, and by init on transitions to run levels 0, 5, 
and 6. Files in the /etc/shutdown.d and /etc/rc0.d directories are executed 
when /etc/rcO isrun. The file KOOANNOUNCE in /etc/rc0.d prints the mes- 
sage System services are now being stopped. Any task that you want 
executed when the system is taken to run levels 0, 8, 5, or 6 can be done by 
adding a file to the /etc/shutdown.d directory. 


/ete/rc0.d Directory 


The /etc/rc0.d directory contains files executed by /etc/rcO for transitions to 
system run levels 0, 5, and 6. Files in this directory are linked from the 
/etc/init.d directory, and begin with either a K or an S. K indicates processes 
that are stopped, and S indicates processes that are started when entering 
run levels 0, 5, or 6. 


letc/re2 File 
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The /etc/rc2 file is a shell script that is executed by /etc/init on transitions to 
run level 2 (multi-user state). Executable files in the /etc/rc.d directory and 
any executable files beginning with S or Kin /etc/rc2.d directories are exe- 
cuted when /etc/rc2 is run. All files in rc2.d are linked from files in the 
/etc/init.d directory. The following are descriptions of some of those files. 
You can add your own custom files to the /etc/rc2.d and /etc/rc.d directories 
if you add hardware or software to the system (see re2(1M)). These files are 
prefixed with an S or a K and a number in the /etc/rc2.d directory. 


MOUNTFSYS Sets up and mounts all filesystems listed in /ete/fstab 
by running the /etc/mountall program. After all filesys- 
tems are mounted, MOUNTFSYS runs quota- 
check(1M) and quotaon(1M) for filesystems that have 
quotas enabled (see fstab(4)). If there is a problem 
mounting any filesystem, a warning is issued and the 
system is returned to single-user mode (see re2(1M). 


PRESERVE Recover editing sessions that may have otherwise been 
lost in the event of a power loss. 

RMTMPFILES Makes the /tmp and /usr/tmp directories, cleaning up 
(deleting) any previous files in that directory. 


addswap Enable multiple disk partitions to be configured as swap 
devices. 
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bootflags Sets up the system specific boot information using the 
/etc/bootflags command. 

cron Starts the cron daemon by executing /etc/cron. 

savecore Saves a system memory dump into the /usr/crash direc- 
tory. 

sysetup Removes /etc/ps_data to force the /bin/ps command to 


read the /unix file. Outputs the system trademark 
information. Puts the version string of the booted ker- 
nel in /ete/motd. 

uucp When basic networking is added to the system, the uucp 
file is added to this directory. The uucp file deletes uucp 
locks (LCK®*), status files (STST*), and temporary files 
(TM*) under the /usr/spool/uucp directory structure. 


Ip The lp file removes the spooler lock file and starts the 
printer scheduler on startup, and stops the scheduler on 
shutdown. 

/ete/rc2.d Directory 


The /etc/rc2.d directory contains files executed by /etc/rc2 for transitions to 
system run level 3. Files in this directory are linked from the /etc/init.d 
directory, and begin with either a K or an S. K indicates processes that 
should be stopped, and S indicates processes that should be started when 
entering run levels 2 or 3. 


letc/re.d Directory 
The /etc/rc.d directory contains executable files that do the various functions 
needed to initialize the system to run level 2. The files are executed when 
/etc/rc2 is run. This directory is maintained only for backward compatibility. 


/ete/rc3 File 
The /etc/rc3 file is executed by /etc/init and. could contain the various func- 
tions needed to initialize the system to run level 3. Run level 3 is a superset of 
tun level 2, in that /etc/rc3 will execute /etc/rc2 if the transition was from a 
run level less than 2. 


/etc/rc3.d Directory 
The /etc/rc3.d directory contains files executed by /etc/rc3 for transitions to 
system run level 3 (multi-user mode). Files in this directory are linked from 
the /etc/init.d directory, and begin with either a K or an S. K indicates 
processes that should be stopped, and S indicates processes that should be 
started when entering run level 3. 


EXAMPLES 
The following shows a typical /etc/rc0 file: 
#! /bin/sh 
# “Run Commands" for init state 0 
# Leaves the system in a state where it 
+ it is safe to turn off the power or go 
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# to firmware. 


echo ‘The system is coming down. Please wait.’ 


# The following segment is for historical purposes. 
¥ There should be nothing in /etc/shutdown.d. 

if [ -d /etc/shutdown.d ] 

then 


for f in /etc/shutdown.d/* 
{ 


if {[ -s $f ] 
then 
/bin/sh ${f£} 
fi 
} 
fi 
# End of historical section 


if [ -d /etc/rc0.d ] 


then 
for f in /etc/rc0.d/K* 
{ 
if [ -s ${f) ] 
then 
/bin/sh ${f} stop 
fi 
} 
+ system cleanup functions ONLY (things that end fast!) 
for f in /etc/rc0.d/s* 
{ 
1£ [ -s ${f} ] 
then 
/bin/sh ${f}° start 
fi 
} 
£i 
trap "" 15 
kill =15. =2 
sleep 5 


/etc/killall 9 
sync; sync; sync 
/etc/umountall 
sync; sync 

echo ’ 

The system is down.’ 
sync 

uadmin 2 0 


12/89 3 


RC(4) DYNIX/ptx 


The following shows a typical /ete/rc2 file: 


#! /bin/sh 

# "Run Commands" executed when the system 

# is changing to init state 2, traditionally 
# called "multi-user". 

# Pickup start-up packages for mounts, 

# daemons, services, etc. 


set ‘who -r‘ 
if [$9 = "Ss" ] 


then 
echo ‘The system is coming up. Please wait.’ 
BOOT=yes 
if [ -f£ /etc/rc.d/PRESERVE ] # historical segment 
then # for vi and ex 


mv /etc/rc.d/PRESERVE /etc/init.d 
ln /etc/init.d/PRESERVE /etc/rc2.d/SO2PRESERVE 
fi 


elif [$7 = "2" ] 


then 
echo ’Changing to state 2.° 
if [ -d /etc/rc2.d ] 
then 
for f in /etc/rc2.d/K* 
{ 
if [ -s ${f} ] 
then 
/bin/sh ${f} stop 
fi 
} 
£i 
Ft 


If the .single_user file gets created, it will contain 
the reason to avoid going multi-user. Send init the 
SINGLE_USER signal, print out the reason for going back 
to single user mode and exit. Init cannot proceed with 
the run-level change until this script exits. 

/bin/rm -f£ /etc/rc2.d/.single_user 

if [ -d /etc/rce2.d ] 

then 


ae Sr Se Se de 


for f in /etc/rce2.d/Ss* 
{ 
1f [ -s ${f} ] 
then 
/bin/sh ${£} start 


status=$? 
if [ -£ /etc/rc2.d/.single_user ]° 
then 
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/etc/init S 

echo ‘*** Going back to SINGLE 
USER mode!’ 

/bin/cat /etc/rc2.d/.single_user 

exit Sstatus 


fi 
Fi 
} 
fi 
4£ [ "${BOOT}" = "yes" -a -d /etc/rc.d ] 
then 
for f in ‘ls /etc/rce.d* 
{ 
if [ ! -s /etc/init.d/${f} ] 
then 
/bin/sh /etc/rc.d/${f} 
£4. 
} 
€i 
if [ "${BOOT}" = "yes" -a $7 = "2" ] 
then 


echo 'The system is ready.’ 
elif [ $7 = "2" ] 
then 

echo 'Change to state 2 has been completed.’ 
fi 


shutdown(1), rc0(1M), re2(1M) 
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NAME 


resfile — format of RCS file 
DESCRIPTION 


An RCS file is an ASCII file. Its contents are described by the grammar below. 
The text is free format; spaces, tabs and new lines have no significance except 
in strings. Strings are enclosed by @. Ifa string contains a @, it must be 
doubled. 


The meta syntax uses the following conventions: | (bar) separates alterna- 
tives; { and } (braces) enclose optional phrases; { and }* enclose phrases that 
may be repeated zero or more times; { and }+ enclose phrases that must appear 
at least once and may be repeated; and < and > enclose nonterminals. 


<restext> = <admin> (<delta>}* <desc> {<deltatext>}* 
<admin> head {<num>}; 
branch {<num>}; 
access {<id>}*; 
symbols {<id> : <num>}*; 
locks {<id> : <num>}*; 
comment {<string>}; 
<delta> <num> 
date <num>; 
author <id>; 
@ state {<id>}; 
branches {<num>}*; 
next {<num>}; 
<desc> desc <string> 
<deltatext> <num> 
log <string> 
text <string> 
<num> ste {<digit>{.}}+ 
<digit> oe Ol1l1..19 
<id> sem <letter>{<idchar>}* 
<letter> n= AIBI.wAIZlalblwdz 
<idchar> s= Any printing ASCII character except space, 
tab, carriage return, new line, and <special>. 
<special> n= pl:1,1@ 


@{any ASCII character, with ‘@’ doubled}*@ 


@ <string> a= 
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Identifiers are case sensitive. Keywords are in lowercase only. The sets of 
keywords and identifiers may overlap. 


The <delta> nodes form a tree. All nodes whose numbers consist of a single 
pair (for example 2.3, 2.1, 1.3) are on the trunk of the tree, and are linked 
through the next field in order of decreasing numbers. The head field in the 
<admin> node points to the head of that sequence (that is, it contains the 
highest pair). The branch node in the admin node indicates the default 
branch (or revision) for most RCS operations. If empty, the default branch is 
the highest branch on the trunk. 


All <delta> nodes whose numbers consist of 2n fields (n22) (for example 
8.1.1.1, 2.1.2.2) are linked in the following way. 


All nodes whose first (2n)-1 number fields are identical are linked 
through the next field in order of increasing numbers. For each such 
sequence, the <delta> node whose number is identical to the first 
2(n-1) number fields of the deltas on that sequence is called the bran- 
chpoint. The branches111leld of a node contains a list of the numbers 
of the first nodes of all sequences for which it is a branchpoint. This 
list is ordered in increasing numbers. 


SEE ALSO 
ci(1), co(1), ident(1), res(1), resdiff{1), resmerge(1), rlog(1) 
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NAME 
reloc — relocation information for a common object file 


SYNOPSIS 
finclude <reloc.h> 


DESCRIPTION 
Object files have one relocation entry for each relocatable reference in the text 
or data. If relocation information is present, it is in the following format: 


struct reloc 

{ 
long xr_vaddr ; /* (virtual) address of reference */ 
long r_symndx ;/* index into symbol table */ 
ushort x_type ; /* relocation type */ 

,F 


#define R_ABS 0 
As the link editor, 1d(1), reads each input section and performs relocation, the 


relocation entries are read. The relocation entries direct how references found 
within the input section are treated, as follows: 


R_ABS The reference is absolute and no relocation is neces- 
sary. The entry will be ignored. 

R_Dinié A direct 16-bit reference to a symbol’s virtual address. 

R_REL16 A‘PC-relative” 16-bit reference to a symbol’s virtual 


address. The actual address is calculated by adding a 
constant to the PC value. 


R_IND16 A 16-bit reference through a transfer vector table. 
R_OFF8 An 8-bit offset reference in 8 bits. 

R_OFFié6 An 8-bit offset reference in 16 bits. 

R_SEG12 A 12-bit segment reference. 

R_AUX An auxiliary relocation entry. 


More relocation types exist for other processors. Equivalent relocation 
types on different processors have equal values and meanings. New 
relocation types will be defined (with new values) as they are needed. 


Relocation entries are generated automatically by the assembler (as 
(1)) and automatically used by the link editor. Link editor options 
exist for both preserving and removing the relocation entries from 
object files. 


SEE ALSO 
as(1), 1d(1), a.out(4), syme(4) 
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NAME 
& secsfile — format of SCCS file 
DESCRIPTION 
An SCCS (Source Code Control System) file is an ASCII file with six logical 
parts: 
the checksum, 
the delta table 
(contains information about each delta), 
user names 
(contains login names and/or numerical group IDs of users who may 
add deltas), 
flags (contains definitions of internal keywords), 


comments 

(contains arbitrary descriptive information about the file), 
the body (contains the actual text lines intermixed with control lines). 
Throughout an SCCS file there are lines which begin with the ASCII SOH 
(start of heading) character (octal 001). This character is referred to here as 
the control character and is represented graphically as @. 
Entries of the form DDDDD represent a five-digit string (a number between 
00000 and 99999). 
Each logical part of an SCCS file is described in detail below. 

@ Checksum 
The checksum is the first line of an SCCS file. The form of the line is 
as follows: 
@hDDDDD 


The value of the checksum is the sum of all characters, except those of the first 
line. The @h provides a magic number of (octal) 064001. 


Delta table 
The delta table consists of a variable number of entries of the form: 


@s DDDDD/DDDDD/DDDDD 

@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 
@i DDDDD .... 

@x DDDDD ... 

@g DDDDD... 

@m <MR number> 


@c <comments> ... 


e - 
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The first line (@s) contains the number of lines inserted/deleted/unchanged, 
respectively. The second line (@d) contains the type of the delta (currently, 
normal: D, and removed: R), the SCCS ID of the delta, the date and time of cre- 
ation of the delta, the 

login name corresponding to the real user ID at the time the delta was 
created, and the serial numbers of the delta and its predecessor, respectively. 


The @i, @x, and @g lines contain the serial numbers of deltas included, 
excluded, and ignored, respectively. These lines are optional. 


The @m lines (optional) each contain one MR number associated with the 
delta; the @c lines contain comments associated with the delta. 


The @e line ends the delta table entry. 


User names 
The list of login names and/or numerical group IDs of users who may 
add deltas to the file, separated by new-lines. The lines containing 
these login names and/or numerical group IDs are surrounded by the 
bracketing lines @u and @U. An empty list allows anyone to make a 
delta. Any line starting with a! prohibits the succeeding group or 
user from making deltas. 


ig Keywords used internally. (See admin(1) for more information on 
their use.) Each flag line takes the form: 
@f <flag> <optional text> 
The following flags are defined: 
@ft  <type of program> 


@fv  <program name> 
@fi  <keyword string> 


@fb 
@fm <module name> 
@ff  <floor> 


@fc <ceiling> 

@fd <default-sid> 

@fn 

@fj 

@f1 <lock-releases> 

@fq  <user defined> 

@fz  <reserved for use in interfaces> 


The t flag defines the replacement for the %Y% identification keyword. The v 
flag controls prompting for MR numbers in addition to comments; if the 
optional text is present it defines an MR number validity checking program. 
The i flag controls the warning/error aspect of the “No id keywords” message. 
When the i flag is not present, this message is only a warning; when the i flag 
is present, this message causes a fatal error (the file is not gotten, or the delta 
is not made). When the b flag is present the -b keyletter may be used on the 
get command to cause a branch in the delta tree. The m flag defines the first 
choice for the replacement text of the %M% identification keyword. The f flag 
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defines the “floor” release; the release below which no deltas may be added. 
The c flag defines the “ceiling” release; the release above which no deltas may 
be added. The d flag defines the default SID to be used when none is specified 
on a get command. The n flag causes delta to insert a “null” delta (a delta 
that applies no changes) in those releases that are skipped when a delta is 
made in a new release (e.g., when delta 5.1 is made after delta 2.7, releases 3 
and 4 are skipped). The absence of the n flag causes skipped releases to be 
completely empty. The j flag causes get to allow concurrent edits of the same 
base SID. The I flag defines a list of releases that are locked against editing 
[get(1) with the -e keyletter]. The q flag defines the replacement for the %Q% 
identification keyword. The z flag is used in certain specialized interface pro- 
grams. 
Comments 
Arbitrary text is surrounded by the bracketing lines @t and @T. The 
comments section typically will contain a description of the file’s pur- 
pose. 
Body 
The body consists of text lines and control lines. Text lines do not 
begin with the control character, control lines do. There are three 
kinds of control lines: insert, delete, and end, represented by the fol- 
lowing, respectively: 


@I DDDDD 
@D DDDDD 
@E DDDDD 


The digit string is the serial number corresponding to the delta for the 
control line. 


SEE ALSO 
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admin(1), delta(1), get(1), prs(1) 
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NAME 


senhdr — section header for a common object file 


SYNOPSIS 


#include <scnhdr.h> 


DESCRIPTION 


SCNHDR(4) 


Every common object file has a table of section headers to specify the layout of 
the data within the file. Each section within an object file has its own header. 
The C structure appears below. 


struct scnhdr 


{ 
char 
long 
long 
long 
long 
long 
long 


unsigned short s_nreloc; 


S_name [SYMNMLEN] ; 
s_paddr; 
s_vaddr; 

s_size; 
s_scnptr; 
s_relptr; 
s_lnnoptr; 


unsigned short s_nlnno; 


long 
,; 


s_flags; 


/* 


/* 
/* 
/* 
/* 
/* 
[* 
/* 
/* 
/* 


section name */ 

Physical address */ 
virtual address */ 

section size */ 

file ptr to raw data */ 
file ptr to relocation */ 
file ptr to line numbers */ 
# reloc entries */ 

# line number entries */ 
flags */ 


File pointers are byte offsets into the file; they can be used as the offsetina 
call to FSEEK (see Idfcn(4)). If a section is initialized, the file contains the 
actual bytes. An uninitialized section has a size, symbols defined in it, and 
symbols that refer to it; but, it can have no relocation entries, line numbers, or 
data. Consequently, an uninitialized section has no raw data in the object file, 
and the values for s_scnptr, s_relptr, s_Innoptr, s_nreloc, and s_nInno are 


zero. 
SEE ALSO 


1d(1), fseek(3S), a.out(4) 
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NAME 
scr_dump — format of curses screen image file 


SYNOPSIS 
scr_dump (file) 


DESCRIPTION 


The curses(3X) function ser_dump() copies the contents of the screen into a 
file. The format of the screen image is described below. 


The name of the ¢ty is 20 characters long and the modification time (the 
mtime of the tty that this is an image of) is of the type time_t. All other num- 
bers and characters are stored as chtype (see <curses.h>). No newlines are 
stored between fields. The screen image format is as follows: 


<magic number: octal 0433> 

<name of tty> 

<mod time of tty> 

<columns> <lines> 

<line length> <chars in line> for each line on the screen 
<line length> <chars in line> 


<labe]ls?> 1, if soft screen labels are present 
<cursor row> <cursor column> 


Only as many characters as are in a line are listed. For example, if the <line 
length> is 0, there will be no characters following <line length>. If <labels?> 
is TRUE, following it will be 


<number of labels> 
<label width> 
<chars in label 1> 
<chars in label 2> 
SEE ALSO 
curses(3X) 
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NAME 


shadow — restricted password file 


DESCRIPTION 


SHADOW(4) 


To protect encrypted user passwords, an optional security feature allows a sys- 
tem administrator to move all password and aging information from the pub- 
licly-readable /etc/ passwd file to an access-restricted file called the shadow 
password file. The shadow password file contains one entry per login (user). 
Each entry consists of the following fields that are colon-separated and in the 
following form: 


username:password:lastchanged:min:max 


username The user’s login name (ID). 


password 


lastchanged 


min 


max 
EXAMPLES 


A13-character encrypted password for the user or a lock 


string to indicate that the login is not accessible; or no string 
which indicates that there is no password for the login. 


The number of days between January 1, 1970, and the date 
that the password was last modified. 


The minimum number of days required between password 


changes. 


The maximum number of days the password is valid. 


A typical portion of a shadow password file follows. Notice the lock string 
NONE in the bin, sys, and adm entries. 


SEE ALSO 


root: :6445:: 

daemon: :6445::; 

bin:NONE:6445:: 

sys:NONE:6445:: 

adm:NONE:6445:: 

uucp: :6445:: 

nuucp: :6445:: 

sync::6445:: 

1p::6445:: 

usrlimit::7069:: 

setup: :6445:: 

powerdown: :6445:: 
sysadm::6445:: 

bupsched: :6445:: 

checkfsys: :6445:: 

mountfsys: :6445:: 
umountfsys::6445:: 
vmsys::6445:: 

oasys::6445:: 
anneh:djw843Kehf73s:6445:90:120 
bobs:x:Iod3iRzt7eRK4 :6445:90:120 
coleenl:1c¢9gj311Vs8xU9:6445:90:120 
dol:mCi9r46jTY9uI:6445:90:120 


passwd(1), passmgmt(1M), passwd(4) 
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NAME 
shells. — shell table 

DESCRIPTION 
The shell table contains a list of initial programs that the "Add a User 
Account” (addusr) command accepts. 


FIELDS 

Shell Description 
This is the description of the shell program. The description is displayed in 
the SELECT window for the shell field in the addusr form. This is a required 
field. 

Shell Executable 
The name of the binary program described in the first field. The program 
must be on disk and should be executable by all users. This value is copied to 
the shell input line when the user selects the corresponding description. This 
is a required field. 


SEE ALSO 
menu(1M) 


NOTES 
Only the superuser (root) can update this file. All users can read this file. 
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NAME 


shutdown — system shutdown information file 


@ DESCRIPTION 


12/89 


The /ete/shutdown file contains a shell script to shut down the system grace- 
fully in preparation for system backup or scheduled downtime. After stopping 
all nonessential processes, the shutdown script executes files in the 
/etc/shutdown.d directory by calling /ete/rc0 for transitions to run level s or 
S. For transitions to other run levels, the shutdown script calls /etc/init. A 
typical /ete/shutdown file follows: 


# Sequence performed to change the init stat of a machine. 
# This procedure checks to see if you are permitted and 
# allows an interactive shutdown. The actual change of 
# state, killing of processes and such are performed by 
# the new init state, say 0, and its /etc/rc0. 
# 
# Usage: 
# shutdown [ -y ] [ -g<grace-period> ] [.-i<init-state> ] 
# 
#! chmod +x ${file} 
# 
# 
4f [ ‘pwd t= / j 
then 
echo "SO: You must be in the / directory to run 
/etc/shutdown." 

exit 1 
fi 
# Check the user id. 
if [ -x /usr/bin/id } 
then 

eval ‘id | sed 's/[*a-z0-9=].*//'' 

Lf [ "S{uid:=0}" -ne 0 ] 

then 

echo "$0: Only root can run /etc/shutdown." 
exit 2 

fi 
fi 
grace=60 
askconfirmation=yes 
initstate=s 
while [ $# -gt 0 ] 
do 


case $1 in 
-g[0-9]* ) 
grace=‘expr "$1" ; ’-g)'* 
-i[Ss0156] ) 
initstate=‘expr "$1" : '-i)'' 


ae 
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=1[234) ) 
initstate=‘expr "$1" ; '-i)'* 
echo "$0: Initstate $i is not for system shutdown" 
exit 1 
-y ) 
askconfirmation= 


-* ) 
echo "Illegal flag argument ’$1'" 
exit 1 
. as 
echo "Usage: $0 [-y] [-g<grace>] [-i<initstate>]" 


exit 1, 
esac 
shift 
done 
if [ -n "S{askconfirmation}"-a -x /etc/ckbupscd ] 
then 
# Check to see if backups are scheduled at this time 
BUPS=‘/etc/ckbupscd * 
41£ r "SBUPS" I= 0" J 
then © 
echo "SBUPS" 
echo "Do you wish to abort this shutdown and return 
to command level to do these backups? [y, n] 
read YORN 
if [ "SYORN" = "y" -o "SYORN" = "Y" J 
then 
exit 1 
fi 
fi 
fi 
df { -z "$(TZ2}" -a -xr /etc/TIMEZONE ] 
then 
/etc/TIMEZONE 
fi 
echo ’ 
Shutdown started. date 
echo 
sync 
edi / 
trap "exit 1" 1215 
a= ‘who ] we -1 an 
if [ ${a} -gt 1 -a S{grace} -gt 0 ] 
then 


su adm -c /etc/wall<<-! 
The system will be shut down in ${grace} seconds. 
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Please log off now. 


sleep ${grace} 
fi 
/etc/wall <<-! 

THE SYSTEM IS BEING SHUT DOWN NOW! ! ! 

Log off now or risk your files being damaged. 
1 


sleep ${grace} 
if [ ${askconfirmation} ] 


then 
echo "Do you want to continue? (y or n): \e" 
read b 
else 
bey 
fi 
Lf [ "Sb" I= ny" J 
then 
/etc/wall <<-\! 
False Alarm: The system will not be brought down. 
1 
echo ‘Shut down aborted.’ 
exit 1 
fi 
case "S{initstate}" in 
s|Ss) 
- /ete/rcd 
esac 


/etc/init ${initstate} 


The executable files in /etc/shutdown.d perform the various functions 
required during the transition to the single-user state (run levels 1, s, or S). 
This directory is only maintained for compatibility reasons. 


SEE ALSO 


shutdown(1), re(4) 
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NAME 
& spellhist — unmatched spelling words file 


DESCRIPTION 
If the spell utility is installed, a history of all words that spell(1) fails to 
match is kept in the /usr/lib/spell/spellhist file. Periodically, this file should 
be reviewed for words that should be added to the dictionary. After the 
spellhist file is reviewed, it can be cleared. 
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NAME 


@ SYNOPSIS 


sulog — log of substitute user events 


SULOG(4) 


The /usr/adm/sulog file contains a history of substitute user (su) com- 
mand usage. As a security measure, this file should not be readable by 
others. The /usr/adm/sulog file should be periodically truncated to keep 
the size of the file within a reasonable limit. Note that /etc/cron, 
/ete/rc0, or /etc/re2 can be used to clean up the sulog file. To use one of 


these functions, add the appropriate command line to the 


/usr/spool/cron/crontab/root, /etc/shutdown.d/..., or /etc/re.d/, rc2.d, 
rce3.d ... file. The following command lines limit the size of the log file to 
the last 100 lines in the file: 


tail -100 /usr/adm/sulog > /tmp/sulog 


mv /tmp/sulog /usr/adm/sulog 


EXAMPLES 
The following is a typical /usr/adm/sulog file. 


sU 08/18 
su 08/18 
SU 08/18 
SU 08/18 
sU 08/19 
sU 08/19 
su 08/19 
SU 08/20 
SU 08/20 
sU 08/20 
su 08/20 
SU 08/20 
sU 08/20 
sU 08/20 
su 08/20 
sU 08/20 
sU 08/20 
SU 08/20 


SEE ALSO 
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su(1M) 


12:35 
16:11 
16:16 
23:45 
21253 
USis25 
23:45 
10:16 
10:33 
10:42 
10:59 
11:01 
12:36 
12:37 
14:42 
14:47 
14:48 
15:44 


(tthe ete et ee tet 


console root-sysadm 
console root-sysadm 
console root-sysadm 
tty?? root-uucp 
console root-sysadm 
console root-sysadm 
tty?? root-uucp 
console root-adm 
tty24 rar-root 
console root-sysadm 
console root-root 
console root-sysadm 
ttyll bin-bin 

ttyll tws-bin 

tty24 awa-sys 

tty24 awa-sys 

tty24 awa-root 
console root-sysadm 
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NAME 
syms — common object file symbol table format 


SYNOPSIS 
#include <syms.h> 


DESCRIPTION 
Common object files contain information to support symbolic software testing 
(debugging). Line number entries, linenum(4), and extensive symbolic infor- 
mation permit testing at the C source level. Every object file’s symbol table 
is organized as shown below. 


File name 1. 
Function 1. 
Local symbols for function 1. 
Function 2. 
Local symbols for function 2. 


Static externs for file 1. 


File name 2. 
Function 1. 
Local symbols for function 1. 
Function 2. 
Local symbols for function 2. 


Static externs for file 2. 


Defined global symbols. 
Undefined global symbols. 


The entry for a symbol is a fixed-length structure. The members of the struc- 
ture hold the name (null padded), its value, and other information. The C 
structure is as follows: 


#define SYMNMLEN 8 
#define FILNMLEN 14 
#define DIMNUM 4 
struct syment 
if 
union /* all ways to get symbol name */ 
{ 
char _N_name[SYMNMLEN]; /* symbol name */ 
struct 
{ 
long _n_zeros; /* == OL when in string table */ 
long _n_ offset; /* location of name in table */ 
} _n_n; 
char *_n_nptr[2]; /* allows overlaying */ 
} _n; 
long n_value; /* value of symbol */ 
short n_scnum; /* section number */ 
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unsigned short 


char 

char 
}e 
#define n_name 
#define n_zeros 
#define n_offset 
#define n_nptr 


DYNIX/ptx 


/* type and derived type */ 
/* storage class */ 
/* number of aux entries */ 


n_type; 
n_sclass; 
n_numaux; 


_n._n_name 
_n.-_n_n._n_zeros 
_n._n_n._n_offset 


n._n_nptr[1) 


Meaningful values and explanations for them are given in both <syms.h> and 
Common Object File Format(COFF). Refer to these sources for more informa- 


tion. 


Some symbols require more information than a single entry; they are followed 
by auxiliary entries that are the same size as a symbol entry. The format fol- 


lows. 


union auxent 


{ 


struct 
{ 
long x_tagndx; 
union 
{ 
struct 
{ 
unsigned shortx_lnno; 
unsigned shortx_size; 
} x_lnsz; 
long x_fsize; 
} x_misc; 
union 
{ 
struct 
{ 
long x_lInnoptr; 
long x_endndx; 
} x_foen; 
struct 
{ 
unsigned shortx_dimen[DIMNUM]; 
} x_ary; 
} x_fenary; 
unsigned short x_tvndx; 
} x_sym; 
struct 
{ 
char x_ fname [FILNMLEN] ; 
} x_file; 
struct 
{ 
long x_scnlen; 
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unsigned short x_nreloc; 
unsigned short x_nlinno; 


} x_scn; 
struct 
{ 
long x_tvfill; 
unsigned short x_tvlen; 
unsigned short x_tvran[2]; 
} x_tv; 


Me 
Indexes of symbol table entries begin at zero. 
SEE ALSO 
sdb(1), a.out(4), linenum(4) 


WARNINGS 
On machines on which ints are equivalent to longs, all longs have their type 
changed to int. Thus the information about which symbols.are declared as 
longs and which as ints does not show up in the symbol table. 
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NAME 


SY8_CONFIG(4) 


sys_config — format of a system configuration file 
@ DESCRIPTION 
The sys_config file describes how the kernel is to be built and what devices 
are to be available when the kernel boots. The directives below may appear in 
any order. Options may appear as a single quantity prepended with an equal 
aign, as a comma-separated list in parentheses, or as a line-delimited list 
enclosed in braces. Comments are preceded with a pound (#) sign. 


The sys_config files must contain at least one of the following sections: 


arch_type 
version 
modules 
device_spec 


The system configuration files usually contain the following sections: 


makeopts 
conf 


confh 


The directives are as follows: 


Directive 
import { options } 


checkfor { options ) 


arch_type (option } 
version { options } 
description { “option” } 
environment { option } 
archive { option } 
makefile { option ) 
modules { options } 


ifTYPE ( parameter ) { 


{ statements } 
) elsifTYPE ( parameter ) { 


{ statements } 
} else { 
{ statements } 


Description 

The named product system configuration 
files must be present, and parsed before 
this one 

The named product system configuration 
files if present, must be parsed before 
this one 

Architecture type - SB8000 

Version support 

Module description 

Anticipated usage environment 

Product archive 

Name of skeleton makefile 

List of compile time modules 


Conditional if7YPE (e.g. ifdef) 

TYPE is one of: config, nconfig, def, ndef, 
product, nproduct. 

- true clause 

Optional else if7YPE (e.g. elsifdef) 

TYPE is one of: config, nconfig, def, ndef, 
product, nproduct. 

- true clause 

Optional else 

- false clause 
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makeopts { options } Makefile options 

conf { options } conf.c options 

confh { options } config.h options 

%RULES { rstring } { string } Make rules 

{dev} on {type} unit{number} Device specification 

pseudo_device { p_spec } Pseudo-device specification 

inits { options } Declare these initialization functions 
print { option } Print argument 

fatal { option } Print argument and abort configuration 
trace Trace toggle 

include { option } Include the named file 

declare [ level ] { params } Declare configurable parameters 
default { defaults } Define default parameter values 
new_default { defaults } Define new default parameter values 
adjust { param_exprs } Adjust parameter values 

set { param_exprs } Set parameter values 

bound [ bound_exprs } Bound parameter values 

assert { assertions } Assert parameter values 


The directive modifiers are as follows: 


Modifier Description 
level Defines parameter visibility level [1..10] 
params List of parameters in the form: 
name type { "description" } 
defaults List of default parameter values: 
name { expr } 


name { expr ; bound } 
param_exprs List of expressions adjusting or setting 
parameter values: 
name { expr } 
bound_exprs List of parameter bound expressions: 


name { bound } 
assertions List of parameter value assertions: 
{expr relop expr ; "assert text"} 
bound Bound interval for parameter: 


low_bound_expr .. 
.. high_bound_expr 
low_bound_expr .. high_bound_expr 


expr Asimple arithmetic expression 
relop Arelational operator: <= < = > >= 
SEE ALSO 


config (1m), mod_config (4) 
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NAME 
syskeymap — identify keys to internal menu system functions 

ptx/ADMIN FEATURE CONTROL FLAG RECORDS (FLAG) 
The FLAG records enable and disable menu system functions. FLAG records 
affect the way the menus and forms are displayed and how the user interacts 
with the programs. 

Record Identifier 

This field has the constant value of flag to identify the record type. 


ptx/ADMIN Feature 
This field selects the features that can be be enabled/disabled by the next field. 


DUMBTERM Is this a dumb terminal? 

UNDINPUT Display input fields with underline video attribute? 

REVTITLE Display title in reverse video attribute? 

REVEMSG Display error messages in reverse video attribute? 

ATTRTRIM Display menu trim with selected video attribute? 

BOLDGRANT Display authorized menu options in bold video attri- 
bute? 

DIMDENY Display unauthorized menu options in dim video attri- 
bute? 

BLINKRUN Display executing menu options in blinking video attri- 
bute? 

REVMBAR Display menu bar in reverse video attribute? 


Feature On/Off 
If this field is YES, the feature will be enabled. If this field is NO, the feature 
will be disabled. 


ptx/ADMIN FUNCTION KEY ASSIGNMENT RECORDS (KEYMAP) 
The KEYMAP records are used to rename or reassign keys to internal menu 
system functions. This feature allows the System Administrator to change the 
control sequence anW/or key label recognized by the menu or forms programs. 
For example, terminals that have a non-standard layout or alternate keycaps 
may have functions mapped to new keys. The descriptions of the functions 
will appear on HELP displays, and the bottom line of menus and forms will 
reflect the new key and/or labels. 


Record Identifier 
This field has the constant value of KEYMAP to identify the record type. 


ptx/ADMIN Feature 
This field selects the function that is remapped by the next field. 


BACK SPACE destructive backspace 


CANCEL cancel 
CHDIR change directory 
CLRFIELD clear field 
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EXTEND 
HELP 
HOME 
INSCHAR 
KEYHELP 
LEFTARROW 
LOCK 
MSGLINE 
PREVIOUS 
PROMPT 
REFRESH 
RIGHTARROW 
ROLLDOWN 
ROLLUP 
RUN 
SHELLCMD 
SPECIAL1 
SPECIAL2 
SPECIAL3 
SPECIAL4 
SPECIAL5 
SPECIAL6 
SPECIAL7 
SPECIALS 
SPECIAL9 
SPECIAL10 
UPARROW 
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copy 
delete character 
down arrow 

exit 

extend field 

help command 
home 

insert character 
keyboard help 
left arrow (non-destructive backspace) 
lock menu 
message line 
previous 

prompt 

display refresh 
right arrow 

roll down 

roll up 
run/send/execute 
shell command 
special function 1 
special function 2 
special function 3 
special function 4 
special function 5 
special function 6 
special function 7 
special function 8 
special function 9 
special function 10 
up arrow 


Alternate Label for Function 


This field allows you to change the external name of the menu system func- 
tion. For example, if you want to change the description of the Page Down 
function to Roll Down on menus and forms, enter Page Down in this field. 


Alternate Mapping(s) for Function 


This field consists of two subfields separated by a comma. The first field is the 
substitute label for the key. The second field is the substitue ASCII Sequence 
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or Terminfo key identifier associated with the function. 


To map a function to a function key, enter the number of the function key fol- 
lowed by the label on the key cap. Function key numbers are listed below: 


Function Key 
Down Arrow 

Up Arrow 

Left Arrow 
Right Arrow 
Home Key 
Backspace Key 
Function Keys 
Delete Character 
Insert Character 
Clear Field 
Next Page 
Previous Page 
Send/Execute 


Number 


402 
403 
404 
405 
406 
407 


410+ function key number 


512 
513 
515 
522 
523 
527 


To substitute an ASCII sequence, enter the octal value of the ASCII character 
followed by a description of the sequence. Do not substitute printable charac- 
ters (for example, letters or numbers) because the results are unpredictable. 


$(TERMINFO}/*/ 


$(TFADMFILE}/keymaps/ 


${TERM) Terminal Description (ter- 
minfo) 

${TERM) Terminal Specific Alternate 
Keymap 
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NAME 
task — global security table 


DESCRIPTION 
The global task table is used as a central repository that contains security and 
implementation information for menu system programs. The information in 
each security entry can be accessed by menu system menus and forms. A 
menu accesses the task table to find out if the user is authorized to execute 
the task, and to find out how to execute the task. A form may access the task 
table to see if the user has authority to a menu or a form. 


FIELDS 
Task Name 
The name of the task. The name must be unique and from 1 to 14 characters 
in length. The task name is upper/lower case sensitive. This is the key to the 
record and all extractions by the menu and menu system commands are based 
on this value. This is a required field. 


Task Type 
The task type option tells the menu program if the task is a menu, program, or 
option modifier. The valid task type codes are: 


M Menu 

P Program 

O Option modifier 
This is a required field. 


Task Description 
This describes the option. It is displayed by the dspsecent and dsptsk com- 
mands and is for reference only. This is an optional field. 


Execution Type 
Use this option to identify how menu driver executes the program task types. 
For task types other than program, this field is ignored. The valid execution 
type codes are listed below: 


SHELL Shell required to execute task. (Default) 
NO SHELL No shell is required to execute task. 
EDC Menu system required to execute task. 


This is an optional field. 


Clear Screen 
This option controls if the screen is cleared before the program is executed and 
if the screen is refreshed (redisplayed) after the program’s completion. For 
task types other than program, this field is ignored. The valid clear screen 
codes are listed below: 


BEHIND Donot clear or redisplay the menu. 

CLEAR Clear menu before task and redisplay after. 

REFRESH Do not clear menu, but redisplay menu after task com- 
pletion. 


This is an optional field. 


Hold Screen 
This option controls the screen after a program is executed. When a program 
task type uses the Hold Screen option, the user must press the RETURN key 
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to refresh the menu. This option is used when a command produces output to 
the screen. It "freezes" the output on the screen and allows the user to review 
the data. 


Use this option with the execution type of program (P) and a clear screen code 
that refreshs the menu. For task types other than program, this field is 
ignored. 


The valid hold screen codes are listed below: 


NOHOLD Donot hold screen after program execution. 
HOLD Hold screen after program execution. 


This is an optional field. 


Authorized Group List 
This option controls the groups that can access the task. If there is more than 
one group, separate the names with commas, or separate the names with 
spaces and enclose the list in quotes. Each group name is verified against the 
group file. The group list option is optional. 
Authorized User List 
This option controls the users that can access the task. If there is more than 
one user, separate the names with commas, or separate the names with spaces 
and enclose the list in quotes. Each user name is verified against the system 
password file. To allow all users access to the task, enter PUBLIC. This is an 
optional field. 
Command String/Menu Name 
The use of the command option is dependent on the execution type. The fol- 
lowing command strings apply to task types: 
P Program or command 
M Menu 
O Option modifier 


This is a required field. 


Help Command 
The menu program uses the help command. If there is a value in this field, 
the value is is concatenated with the value in the next field (the help file) and 
then executed. If the value is HELPCMD, the system control file is opened 
and the default Help Command (such as ’man’) is substituted. This is an 
optional field. 

Help File 
The help file is used by the menu program. If there is a value in the previous 
field, Help Command, the value of this field is concatenated with the help com- 
mand and then executed. If the help command field is null, the file is opened 
by the menu driver and the text delimited by the Help Keywords (the next 
field) is displayed in the help window. This is an optional field. . 


Help Keywords 
The help keywords are used by the menu program. If help text exists (as 
determined by the Help Command and Help File), the value in this field is 
used to delimit the text relevant to the current option. If this field is null, all 
text is passed through to the help window. If one or more words (comma 
separated) are specified, lines starting with a period (in the first column only) 
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followed directly by a keyword (.keyword) will initiate extraction of the text. 
Lines starting with a period and a tildeyword) will terminate extraction of the 

© text. The entire file is scanned for all keywords that are noted. This is an 
optional field. 


SEE ALSO 
menu(1M) 


NOTES 
Only the superuser (root) can update this file. All users can read this file. 
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NAME 


term — format of compiled term file 


SYNOPSIS 


Aasr/lib/terminfo/?/+ 


DESCRIPTION 
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Compiled terminfo(4) descriptions are placed under the directory 
/usr/lib/terminfo. In order to avoid a linear search of a huge operating sys- 
tem directory, a two-level scheme is used: /usr/lib/terminfo/c/name where 
name is the name of the terminal, and c is the first character of name. Thus, 
att4425 can be found in the file /usr/lib/terminfo/a/att4425. Synonyms for 
the same terminal are implemented by multiple links to the same compiled 
file. 


The format has been chosen so that it is the same on all hardware. An 8-bit 
byte is assumed, but no assumptions about byte ordering or sign extension are 
made. Thus, these binary terminfo(4) files can be transported to other hard- 
ware with 8-bit bytes. 


Short integers are stored in two 8-bit bytes. The first byte contains the least 
significant 8 bits of the value, and the second byte contains the most signifi- 
cant 8 bits. (Thus, the value represented is 256*second+first.) The value -lis 
represented by 0377,0377, and the value -2 is represented by 0376,0377; other 
negative values are illegal. Computers where this does not correspond to the 
hardware read the integers as two bytes and compute the result, making the 
compiled entries portable between machine types. The -1 generally means 
that a capability is missing from this terminal. The -2 means that the capa- 
bility has been canceled in the terminfo(4) source and also is to be considered 
missing. 

The compiled file is created from the source file descriptions of the terminals 
(see the -I option of infocmp(1M)) by using the terminfo(4) compiler, 
tic(1M), and read by the routine setupterm(). (See curses(3X).) The file is 
divided into six parts: the header, terminal names, boolean flags, numbers, 
strings, and string table. 


The header section begins the file. This section contains six short integers in 
the format described below. These integers are (1) the magic number (octal 
0432); (2) the size, in bytes, of the names section; (3) the number of bytes in 
the boolean section; (4) the number of short integers in the numbers section; 
(5) the number of offsets (short integers) in the strings section; (6) the size, in 
bytes, of the string table. 


The terminal names section comes next. It contains the first line of the ter- 
minfo(4) description, listing the various names for the terminal, separated by 
the bar ( | ) character (see term(5)). The section is terminated with an ASCII 
NULL character. 


The boolean flags have one byte for each flag. This byte is either 0 or 1as the 
flag is present or absent. The value of 2 means that the flag has been can- 
celed. The capabilities are in the same order as the file <term.h>. 


Between the boolean section and the number section, a null byte is inserted, if 
necessary, to ensure that the number section begins on an even byte. All 
short integers are aligned on a short word boundary. 
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The numbers section is similar to the boolean flags section. Each capability 
takes up two bytes, and is stored as a short integer. If the value represented 
is -1 or -2, the capability is taken to be missing. 


The strings section is also similar. Each capability is stored as a short integer, 
in the format above. A value of —1 or -2 means the capability is missing. 
Otherwise, the value is taken as an offset from the beginning of the string 
table. Special characters in “X or \c notation are stored in their interpreted 
form, not the printing representation. Padding information ($<nn>) and 
parameter information (%x) are stored intact in uninterpreted form. 


The final section is the string table. It contains all the values of string capa- 
bilities referenced in the string section. Each string is null terminated. 


Note that it is possible for setupterm() to expect a different set of capabilities 
than are actually present in the file. Either the database may have been 
updated since setupterm() has been recompiled (resulting in extra unrecog- 
nized entries in the file) or the program may have been recompiled more 
recently than the database was updated (resulting in missing entries). The 
routine setupterm() must be prepared for both possibilities — this is why the 
numbers and sizes are included. Also, new capabilities must always be added 
at the end of the lists of boolean, number, and string capabilities. 


As an example, an octal dump of the description for the AT&T Model 37 KSR is 
included: 


37|tty37|AT&T model 37 teletype, 
he, os, xon, 
bel="G, cr=\r, cubl=\b, cudl=\n, cuvl=\E7, hd=\E9, 
hu=\E8, ind=\n, 


0000000 032 001 \O 032 \0 013 \0 021001 3 \O 3 7 | t 
0000020 t y 3 7 | A T & T mo deol 
0000040 3 7 t e 1 et y pe \O \O \O \O \O 
0000060 \O \O \0 001 \O \O \O \O \O \O \0 001 \O \O \oO \o 
0000100 001 \O \O \O \O \O 377 377 377 377 377 377 377 377 377 377 
0000120 377 377 377 377 377 377 377 377 377 377 377 377 377 377 & \O 
0000140 \O 377 377 S77 277 377 377 377 377 377 377 377 377 377 377 
0000160 377 377. " \O 377 377 377 377 ( \O 377 377 377 377 377 377 
0000200 377 377 O \O 377 377 377 377 377 377 377 377 - \O 377 377 
0000220 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 
* 

0000520 377 377 377 377 377 377 377 377 377 377 377 377 377 377 S$ \O 
0000540 377 377 377 377 377 377 377 377 377 377 377 377 377 377 * \O 
0000560 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 
* . 

0001160 377 377 377 377 377 377 377 377 377 377 377 377 377 377 3 «7 
0001200 =| t t y 3 F | A T & T mo ode 
0001220 +1 3 Ff t e let y p e \O \r \O 
0001240 \n \O \n \0 007 \O \b \0 033 8 \0 033 9 \0 033 7 
0001260 \O \0 

0001261 
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Some limitations: total compiled entries cannot exceed 4096 bytes; all entries 
© in the name field cannot exceed 128 bytes. 
FILES 


/usr/lib/terminfo/?/* Compiled terminal description database 
/usr/include/term.h terminfo(4) header file 
SEE ALSO 


infocmp(1M), curses(3X), terminfo(4), term(5) 
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NAME 


termcap — terminal capability data base 


SYNOPSIS 


/etc/termcap 


DESCRIPTION 


termcap is a database file that describes terminal capabilities. The termcap 
database is obsolete and is provided for backward compatibility; the ter- 
minfo(4) database should be used instead. Entries in termcap describe termi- 
nal capabilities and how operations are performed. Padding requirements and 
initialization sequences are included in termcap. 


Entries in termcap consist of a number of colon (:) separated fields. The first 
entry for each terminal gives the name or names that are known for the termi- 
nal, separated by pipe (|) characters. The first name is always 2 characters 
long and is used by older Version 6 UNIX systems which store the terminal 
type in a 16 bit word in a systemwide data base. The second name given is the 
most common abbreviation for the terminal, and the last name given should 
be a long name fully identifying the terminal. The second name should con- 
tain no blanks; the last name may well contain blanks for readability. 


CAPABILITIES 
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(P) indicates padding may be specified 
(P*) indicates that padding may be based on no. lines affected 


Name Type Pad? Description 

ae str (P) End alternate character set 

al str (P*) Addnew blank line 

am __ bool Terminal has automatic margins 

as str (P) Start alternate character set 

be str Backspace if not “H 

bs bool Terminal can backspace with “H 

bt str (P) Back tab 

bw bool Backspace wraps from column 0 to last column 

CC seastr Command character in prototype if terminal settable 
cd str (P*) Clear toend of display 

ce str (P) Clear toendofline 

ch str (P) Like cm but horizontal motion only, line stays same 
cl str (P*) Clear screen 

cm str (P) Cursor motion 

co num Number of columns in a line 

cr str (P*) Carriage return, (default “M) 


cs str (P) Change scrolling region (vt100), like cm 


cv str (P) Like ch but vertical only. 

da _ _ bool Display may be retained above 

dB num Number of millisec of bs delay needed 
db _ bool Display may be retained below 

dC num Number of millisec of cr delay needed 
dc str (P*) Delete character 

dF num Number of millisec of ff delay needed 
dl str (P*) Delete line 

dm str Delete mode (enter) 


str (P*) 


str (P) 


str (P) 


str (P*) 


str (P*) 


str 
str (P) 
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Number of millisec of nl delay needed 
Down one line 

Display status line 

Number of millisec of tab delay needed 
End delete mode 

End insert mode; give :ei=: if ic 

Can erase overstrikes with a blank 
Supports escape sequences on status line 
Hardcopy terminal page eject (default “L) 
End writing to status line 

Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 
Home cursor (if no em) 

Has a status line 

Half-line up (reverse 1/2 linefeed) 
Hazeltine; can’t print ’s 

Secondary terminal initialization string 
Insert character 

Name of file containing is 

Insert mode (enter); give :im=: if ic 
Insert mode distinguishes nulls on display 
Insert pad after character inserted 
Terminal initialization string 

Sent by other function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 

Out of keypad transmit mode 

Sent by home key 

Sent by terminal left arrow key 

Number of other keys 

Termcap entries for other non-function keys 
Sent by terminal right arrow key 

Put terminal in keypad transmit mode 
Sent by terminal up arrow key 

Labels on other function keys 

Number of lines on screen or page 

Last line, first column (if no em) 

Arrow key map, used by vi version 2 only 
Safe to move while in insert mode 
Memory lock on above cursor. 

Safe to move while in standout and underline mode 
Memory unlock (turn off memory lock). 
No correctly working carriage return (DM2500,H2000) 
Non-destructive space (cursor right) 
Newline character (default \n) 

Terminal is a CRT but doesn’t scroll. 
Terminal overstrikes 

Pad character (rather than null) 

Has hardware tabs (may need to be set with is) 
End stand out mode 

Scroll forwards 
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sg num Number of blank chars left by so or se 

sO str Begin stand out mode 

sr str (P) Scroll reverse (backwards) 

ta str (P) Tab (other than “I or with padding) 

te str Entry of similar terminal - must be last 

te str String to end programs that use cm 

ti str String to begin programs that use cm 

ts str Begin writing to status line 

uc str Underscore one char and move past it 

ue str End underscore mode 

ug num Number of blank chars left by us or ue 

ul bool Terminal underlines though it doesn’t overstrike 
up str Upline (cursor up) 

us str Start underscore mode 

vb str Visible bell (may not move cursor) 

ve str Sequence to end open/visual mode 

vs str Sequence to start open/visual mode 

xb bool Beehive (fl=escape, f2=ctrl C) 

xn ___ bool A newline is ignored after a wrap (Concept) 

xr bool Return acts like ce \r \n (Delta Data) 

xs bool Standout not erased by writing over it (HP 264?) 
xt bool Tabs are destructive, magic so char (Teleray 1061) 
A Sample Entry 


The following entry, which describes the Concept-100, is among the more 
complex entries in the termcap file as of this writing. (This particular concept 
entry is outdated, and is used as an example only.) 


c11c1001 concept100:is=\EU\Ef\E7\E5\E8\E]\ENH\EK\E\200\Eo0&\200:\ 
val=3*\ E*R:am:bs:cd=16* \E"C:ce=16\E’S:cl=2**L:cm=\Ea%+ %+ :co#80:\ 
:de=16\E*A:dl=3*\E*B:ei=\E\200:eo:im=\E’P:in:ip=16*:li#24:mi:nd=\E=:\ 
:se=\Ed\Ee:so=\ED\EE:ta=8 \t:ul:up=\E;:vb=\Ek\EK:xn: 

Entries may continue onto multiple lines by giving a \ as the last character of 
a line, and that empty fields may be included for readability (here between the 
last field on a line and the first field on the next). Capabilities in termcap are 
of three types: Boolean capabilities which indicate that the terminal has some 
particular feature, numeric capabilities giving the size of the terminal or the 
size of particular delays, and string capabilities, which give a sequence which 
can be used to perform particular terminal operations. 


Types of Capabilities 


All capabilities have two letter codes. For instance, the fact that the Concept 
has automatic margins (i.e. an automatic return and linefeed when the end of 
a line is reached) is indicated by the capability am. Hence the description of 
the Concept includes am. Numeric capabilities are followed by the character 
and then the value. Thus co which indicates the number of columns the 
terminal has gives the value ‘80’ for the Concept. 


Finally, string valued capabilities, such as ce (clear to end of line sequence) 
are given by the two character code, an ‘=’, and then a string ending at the 
next following ‘:’. A delay in milliseconds may appear after the ‘=’ in such a 
capability, and padding characters are supplied by the editor after the 
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remainder of the string is sent to provide this delay. The delay can be either a 
integer, e.g. ‘20’, or an integer followed by an ‘, i.e. ‘3*. A‘ indicates that 
the padding required is proportional to the number of lines affected by the 
operation, and the amount given is the per-affected-unit padding required. 
When a “* is specified, it is sometimes useful to give a delay of the form ‘3.5’ 
specify a delay per unit to tenths of milliseconds. 


Anumber of escape sequences are provided in the string valued capabilities 
for easy encoding of characters there. A \E maps to an ESCAPE character, “x 
maps to a control-x for any appropriate x, and the sequences \n \r \t \b \f 
give a newline, return, tab, backspace and formfeed. Finally, characters may 
be given as three octal digits after a \, and the characters * and \ may be 
given as \“and \\. If it is necessary to place a: in a capability it must be 
escaped in octal as \072. If it is necessary to place a null character in a string 
capability it must be encoded as \200. The routines which deal with termcap 
use C strings, and strip the high bits of the output very late so that a \200 
comes out as a \000 would. 

Preparing Descriptions 

We now outline how to prepare descriptions of terminals. The most effective 
way to prepare a terminal description is by imitating the description of a simi- 
lar terminal in termcap and to build up a description gradually, using partial 
descriptions with ex to check that they are correct. Be aware that a very 
unusual terminal may expose deficiencies in the ability of the termcap file to 
describe it or bugs in ex. To easily test a new terminal description you can set 
the environment variable TERMCAP to a pathname of a file containing the 
description you are working on and the editor will look there rather than in 
/etc/termcap. TERMCAP can also be set to the termcap entry itself to avoid 
reading the file when starting up the editor. (This only works on version 7 
systems.) 

Basic capabilities 

The number of columns on each line for the terminal is given by the co 
numeric capability. If the terminal is a cRT, then the number of lines on the 
screen is given by the li capability. If the terminal wraps around to the begin- 
ning of the next line when it reaches the right margin, then it should have the 
am capability. If the terminal can clear its screen, then this is given by the cl 
string capability. If the terminal can backspace, then it should have the bs 
capability, unless a backspace is accomplished by a character other than “H 
(ugh) in which case you should give this character as the be string capability. 
If it overstrikes (rather than clearing a position when a character is struck 
over) then it should have the os capability. 


Avery important point here is that the local cursor motions encoded in 
termcap are undefined at the left and top edges of a CRT terminal. The editor 
will never attempt to backspace around the left edge, nor will it attempt to go 
up locally off the top. The editor assumes that feeding off the bottom of the 
screen will cause the screen to scroll up, and the am capability tells whether 
the cursor sticks at the right edge of the screen. If the terminal has switch 
selectable automatic margins, the termcap file usually assumes that this is on 
(.e., am). ; 
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These capabilities suffice to describe hardcopy and glass-tty terminals. Thus 
the model 33 teletype is described as 


t3 | 33 | tty33:co#72:08 
while the Lear Siegler ADM-3 is described as 

el | adm | 3 | 1si adm3:am:bs:cl="Z:1i#24:co#80 
Cursor addressing 


Cursor addressing in the terminal is described by a cm string capability, with 
printf(3S) like escapes %x in it. These substitute to encodings of the current 
line or column position, while other characters are passed through unchanged. 
If the em string is thought of as being a function, then its arguments are the 
line and then the column to which motion is desired, and the % encodings 
have the following meanings: 


%d as in printf, 0 origin 


%2 like %2d 
%3 like %3d 
% like %c 


%+x  adds~x to value, then %. 

%>xy if value > x adds y, no output. 

wr reverses order of line and column, no output 

Ri increments line/column (for 1 origin) 

%% gives a single % 

%n exclusive or row and column with 0140 (DM2500) 
%B BCD (16*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2*(x%16)), no output. (Delta Data). 


Consider the HP2645, which, to get to row 3 and column 12, needs to be sent 
\E&al12c08Y padded for 6 milliseconds. Note that the order of the rows and 
columns is inverted here, and that the row and column are printed as two 
digits. Thus its em capability is cm=6\E&%r%2c%2Y. The Microterm ACT-IV 
needs the current row and column sent preceded by a “T, with the row and col- 
umn simply encoded in binary, cm="T%.%.. Terminals which use %. need to be 
able to backspace the cursor (bs or be), and to move the cursor up one line on 
the screen (up introduced below). This is necessary because it is not always 
safe to transmit \t, \n “D and \r, as the system may change or discard them. 


A final example is the LSI ADM-3a, which uses row and column offset by a blank 
character, thus cm=\E=%+ %+ . 


Cursor motions 


If the terminal can move the cursor one position to the right, leaving the char- 
acter at the current position unchanged, then this sequence should be given as 
nd (non-destructive space). Ifit can move the cursor up a line on the screen in 
the same column, this should be given as up. If the terminal has no cursor 
addressing capability, but can home the cursor (to very upper left corner of 
screen) then this can be given as ho; similarly a fast way of getting to the 
lower left hand corner can be given as ll; this may involve going up with up 
from the home position, but the editor will never do this itself (unless Il does) 
because it makes no assumption about the effect of moving up from the home 


position. 
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Area clears 


If the terminal can clear from the current position to the end of the line, leav- 
ing the cursor where it is, this should be given as ce. If the terminal can clear 
from the current position to the end of the display, then this should be given 
as cd. The editor only uses ed from the first column of a line. 


Insert/delete line 


If the terminal can open a new blank line before the line where the cursor is, 
this should be given as al; this is done only from the first position of a line. 
The cursor must then appear on the newly blank line. If the terminal can 
delete the line which the cursor is on, then this should be given as dl; this is 
done only from the first position on the line to be deleted. If the terminal can 
scroll the screen backwards, then this can be given as sb, but just al suffices. 
If the terminal can retain display memory above then the da capability should 
be given; if display memory can be retained below then db should be given. 
These let the editor understand that deleting a line on the screen may bring 
non-blank lines up from below or that scrolling back with sb may bring down 
non-blank lines. 


Insert/delete character 


There are two basic kinds of intelligent terminals with respect to insert/delete 
character which can be described using termcap. The most common 
insert/delete character operations affect only the characters on the current 
line and shift characters off the end of the line rigidly. Other terminals, such 
as the Concept 100 and the Perkin Elmer Owl, make a distinction between 
typed and untyped blanks on the screen, shifting upon an insert or delete only 
to an untyped blank on the screen which is either eliminated, or expanded to 
two untyped blanks. You can find out which kind of terminal you have by 
clearing the screen and then typing text separated by cursor motions. Type 
abc def using local cursor motions (not spaces) between the abc and the def. 
Then position the cursor before the abc and put the terminal in insert mode. 
If typing characters causes the rest of the line to shift rigidly and characters 
to fall off the end, then your terminal does not distinguish between blanks and 
untyped positions. If the abc shifts over to the def which then move together 
around the end of the current line and onto the next as you insert, you have 
the second type of terminal, and should give the capability in, which stands 
for insert null. If your terminal does something different and unusual then 
you may have to modify the editor to get it to use the insert mode your termi- 
nal defines. We have seen no terminals which have an insert mode not not 
falling into one of these two classes. 


The editor can handle both terminals which have an insert mode, and termi- 
nals which send a simple sequence to open a blank position on the current 
line. Give as im the sequence to get into insert mode, or give it an empty 
value if your terminal uses a sequence to insert a blank position. Give as ei 
the sequence to leave insert mode (give this, with an empty value also if you 
gave im so). Now give as ic any sequence needed to be sent just before send- 
ing the character to be inserted. Most terminals with a true insert mode will 
not give ic, terminals which send a sequence to open a screen position should 
give it here. (Insert mode is preferable to the sequence to open a position on 
the screen if your terminal has both.) If post insert padding is needed, give 
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this as a number of milliseconds in ip (a string option). Any other sequence 
which may need to be sent after an insert of a single character may also be 
given in ip. 

It is occasionally necessary to move around while in insert mode to delete 
characters on the same line (e.g. if there is a tab after the insertion position). 
If your terminal allows motion while in insert mode you can give the capabil- 
ity mi to speed up inserting in this case. Omitting mi will affect only speed. 
Some terminals (notably Datamedia’s) must not have mi because of the way 
their insert mode works. 


Finally, you can specify delete mode by giving dm and ed to enter and exit 
delete mode, and dc to delete a single character while in delete mode. 


Highlighting, underlining, and visible bells 


If your terminal has sequences to enter and exit standout mode these can be 
given as so and se respectively. If there are several flavors of standout mode 
(such as inverse video, blinking, or underlining — half bright is not usually an 
acceptable standout mode unless the terminal is in inverse video mode con- 
stantly) the preferred mode is inverse video by itself. If the code to change 
into or out of standout mode leaves one or even two blank spaces on the 
screen, as the TVI 912 and Teleray 1061 do, then ug should be given to tell 
how many spaces are left. 


Codes to begin underlining and end underlining can be given as us and ue 
respectively. If the terminal has a code to underline the current character 
and move the cursor one space to the right, such as the Microterm Mime, this 
can be given as uc. (Ifthe underline code does not move the cursor to the 
right, give the code followed by a nondestructive space.) 


Many terminals, such as the HP 2621, automatically leave standout mode 
when they move to a new line or the cursor is addressed. Programs using 
standout mode should exit standout mode before moving the cursor or sending 
a newline. 


If the terminal has a way of flashing the screen to indicate an error quietly (a 
bell replacement) then this can be given as vb; it must not move the cursor. If 
the terminal should be placed in a different mode during open and visual 
modes of ex, this can be given as vs and ve, sent at the start and end of these 
modes respectively. These can be used to change, e.g., from a underline toa 
block cursor and back. 


If the terminal needs to be in a special mode when running a program that 
addresses the cursor, the codes to enter and exit this mode can be given as ti 
and te. This arises, for example, from terminals like the Concept with more 
than one page of memory. If the terminal has only memory relative cursor 
addressing and not screen relative cursor addressing, a one screen-sized win- 
dow must be fixed into the terminal for cursor addressing to work properly. 


If your terminal correctly generates underlined characters (with no special 
codes needed) even though it does not overstrike, then you should give the 
capability ul. If overstrikes are erasable with a blank, then this should be 


indicated by giving eo. 
Keypad 
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If the terminal has a keypad that transmits codes when the keys are pressed, 
this information can be given. Note that it is not possible to handle terminals 
where the keypad only works in local (this applies, for example, to the 
unshifted HP 2621 keys). If the keypad can be set to transmit or not transmit, 
give these codes as ks and ke. Otherwise the keypad is assumed to always 
transmit. The codes sent by the left arrow, right arrow, up arrow, down 
arrow, and home keys can be given as kl, kr, ku, kd, and kh respectively. If 
there are function keys such as f0, fl, ..., £9, the codes they send can be given 
as k0, k1,..., k9. If these keys have labels other than the default f0 through 
f9, the labels can be given as 10, l1,...,19. If there are other keys that transmit 
the same code as the terminal expects for the corresponding function, such as 
clear screen, the termcap 2 letter codes can be given in the ko capability, for 
example, :ko=cl,l,sf,sb:, which says that the terminal has clear, home down, 
scroll down, and scroll up keys that transmit the same thing as the cl, ll, sf, 
and sb entries. 


The ma entry is also used to indicate arrow keys on terminals which have 
single character arrow keys. It is obsolete but still in use in version 2 of vi, 
which must be run on some minicomputers due to memory limitations. This 
field is redundant with kl, kr, ku, kd, and kh. It consists of groups of two 
characters. In each group, the first character is what an arrow key sends, the 
second character is the corresponding vi command. These commands are h for 
kl, j for kd, k for ku, | for kr, and H for kh. For example, the mime would be 
sma="Kj-Zk*Xl: indicating arrow keys left ("H), down (“K), up (‘Z), and right 
(‘X). (There is no home key on the mime.) 


Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then this 
can be given as pe. 

If tabs on the terminal require padding, or if the terminal uses a character 
other than “I to tab, then this can be given as ta. 


Hazeltine terminals, which don’t allow tilde characters to be printed should 
indicate hz. Datamedia terminals, which echo carriage-return linefeed for 
carriage return and then ignore a following linefeed should indicate nc. Early 
Concept terminals, which ignore a linefeed immediately after an am wrap, 
should indicate xn. If an erase-eol is required to get rid of standout (instead of 
merely writing on top of it), xs should be given. Teleray terminals, where tabs 
turn all characters moved over to blanks, should indicate xt. Other specific 
terminal problems may be corrected by adding more capabilities of the form 
xx. 

Other capabilities include is, an initialization string for the terminal, and if, 
the name of a file containing long initialization strings. These strings are 
expected to properly clear and then set the tabs on the terminal, if the termi- 
nal has settable tabs. If both are given, is will be printed before if. This is 
useful where if is /usr/lib/tabset/std but is clears the tabs first. 


Similar Terminals 


If there are two very similar terminals, one can be defined as being just like 
the other with certain exceptions. The string capability te can be given with 
the name of the similar terminal. This capability must be last and the com- 
bined length of the two entries must not exceed 1024. Since termlib routines 
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search the entry from left to right, and since the tc capability is replaced by 
the corresponding entry, the capabilities given at the left override the ones in 
the similar terminal. A capability can be canceled with xx@ where xx is the 
capability. For example, the entry 


hn | 2621n1]:ks@:ke@:tc=2621: 


defines a 2621n] that does not have the ks or ke capabilities, and hence does 
not turn on the function key labels when in visual mode. This is useful for dif- 
ferent modes for a terminal, or for different user preferences. 


FILES 

/etc/termcap file containing terminal descriptions 
SEE ALSO 

terminfo(4), captoinfo(1M) 
AUTHOR 

William Joy 


Mark Horton added underlining and keypad support 


BUGS 
The ma, vs, and ve entries are specific to the vi program. 


Not all programs support all entries. There are entries that are not supported 
by any program. 
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NAME 

terminfo — terminal capability database 
SYNOPSIS 

/usr/lib/terminfo/?/+ 
DESCRIPTION 
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terminfo is a database, produced by tic(1M), that describes the capabilities of 
devices such as terminals and printers. Devices are described in terminfo 
source files by specifying a set of capabilities, by quantifying certain aspects of 
the device, and by specifying character sequences that effect particular 
results. This database is often used by screen oriented applications such as 
vi(1) and curses(3X), as well as by some operating system commands such as 
Is(1) and pg(1). This usage allows them to work with a variety of devices 
without changes to the programs. To obtain the source description for a 
device, use the infoemp(1M) command. 


terminfo source files consist of one or more device description entries. Each 
entry consists of a header (beginning in column 1) and one or more lines that 
list the features for that particular device. Each line in a terminfo source file, 
except the header, must be indented with one or more white spaces (either 
spaces or tabs); and each line must end in a comma (,). 


Entries consist of a number of comma-separated fields; white space after each 
comma is ignored. Embedded commas must be escaped by using a backslash. 
The following example shows the format of a terminfo source file: 


aliasl | alias2 | ... | aliasN | longname, 
#24, 
home=\Eeh, 


The first line, commonly referred to as the header line, must begin in column 
one and must contain at least two aliases, separated by vertical bars. The last 
field in the header line must be the long name of the device and it may contain 
any string. Alias names must be unique in the terminfo database and they 
must conform to operating system file naming conventions (see tic(1M)); for 
example they cannot contain white space or slashes. 


Every device must be assigned a name, such as “att5425" (for the AT&T model 
5425 device). Device names (except the long name) should be should not con- 
tain hyphens because hyphens are reserved for use when adding suffixes that 
indicate special modes for hardware. or modes for user preference. 


To assign a special modes to a particular device, append a suffix, consisting of 
a hyphen and an indicator of the mode, to the device name. For example, the 
-w suffix means wide mode; when specified, it allows for a width of 132 col- 
umns instead of the standard 80 columns. Therefore, if you want to use an 
AT&T 5425 device set to wide mode, name the device "att5410-w.” Use the fol- 
lowing suffixes where possible. 

Suffix Meaning Example 


-w Wide mode (more than 80 columns) 5410-w 


TERMINFO(4) DYNIX/ptx 
-am With auto. margins (usually default) vt100-am 
-nam Without automatic margins vt100-nam 
n Number of lines on the screen 2300-40 
-na No arrow keys (leave them in local) c100-na 
-np Number of pages of memory c100-4p 
-rv Reverse video 4415-rv 


PART 1 DEVICE CAPABILITIES 
Three types of capabilities are included in the terminfo file: 


¢ Boolean capabilities which show that a device has or does not have a par- 
ticular feature. 


¢ Numeric capabilities which quantify particular features of a device. 


¢ String capabilities which provide sequences that can be used to perform 
particular operations on devices. 


In the following tables, a Variable is the name by which a C programmer 
accesses a capability (at the terminfo level). A Capname is the short name for 
a capability specified in the terminfo source file. It is used by a person updat- 
ing the source file and by the tput(1) command. A Termeap Code is a two- 
letter sequence that corresponds to the termcap capability name. (Note that 
termcap is no longer supported.) 


Capability names have an informal limit of five characters to keep them short. 
Whenever possible, capability names are chosen to be the same as or similar 
to those specified by the ANSI X3.64-1979 standard. Semantics are also 
intended to match those of the ANSI standard. 


All string capabilities listed below may have padding specified, with the excep- 
tion of those used for input. Input capabilities, listed under the Strings sec- 
tion in the following tables, have names beginning with key_. The #i symbol 
in the description field of the following tables refers to the ith parameter. 


Booleans 

Cap- Termcap 
Variable name Code Description 
auto_left_margin bw bw cubl wraps from column 0 to last column 
auto_right_margin am am Terminal has automatic margins 
back_color_erase bee be Screen erased with background color 
can_change ece cc Terminal can re-define existing color 
ceol_standout_glitch xhp xB Standout not erased by overwriting (hp) 
col_addr_glitch xhpa YA Only positive motion for hpa/mhpa caps 
cpi_changes_res cpix YF Changing char pitch changes resolution 
cr_cancels_micro_mode crxm YB Using cr turns off micro mode 
eat_newline_glitch xenl xn Newline ignored after 80 columns (Concept) 
erase_overstrike eo eo Can erase overstrikes with a blank 
generic_type gn gn Generic line type (e.g., dialup, switch) 
hard_copy he he Hardcopy terminal 
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Varlable 


hard_cursor 
has_meta_key 
has_print_wheel 
has_status_line 


hue_lightness_saturation 


insert_null_glitch 
lpi_changes_res 
memory_above 
memory_below 
move_insert_mode 
move_standout_mode 
needs_xon_xoff 
no_esc_ctle 
non_rev_rmcup 
no_pad_char 
over_strike 
prtr_silent 
row_addr_glitch 


semi_auto_right_margin 


status_line_esc_ok 


dest_tabs_magic_smso 


tilde_glitch 


transparent_underline 


xon_xoff 


Numbers 


Variable 


buffer_capacity 
columns 
dot_vert_spacing 
dot_horz_spacing 
init_tabs 
label_height 
label_width 

lines 
lines_of_memory 
magic_cookie_glitch 
max_colors 
max_micro_address 
max_micro_jump 
max_pairs 
micro_col_size 
micro_Jine_size 
no_color_video 
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Description 


Cursor is hard to see 

Has a meta key (shift, sets parity bit) 
Printer needs operator to change char set 
Has extra "status line” 

Terminal uses only HLS color notation (Tektronix) 
Insert mode distinguishes nulls 

Changing line pitch changes resolution 
Display may be retained above the screen 
Display may be retained below the screen 
Safe to move while in insert mode 

Safe to move in standout modes 

Padding won’t work, xon/xoff required 
Beehive (fl=escape, f2=ctrl C) 

smcup does not reverse rmcup 

Pad character doesn’t exist 

Terminal overstrikes on hard-copy terminal 
Printer won't echo on screen 

Only positive motion for vpa/mvpa caps 
Printing in last column causes cr 

Escape can be used on the status line 
Destructive tabs, magic smso char (t1061) 
Hazeltine; can’t print tilde (~) 

Underline character overstrikes 

Terminal uses xon/xoff handshaking 


Description 


Number of bytes buffered before printing 
Number of columns in a line 

Spacing of pins vertically in pins per inch 
Spacing of dots horizontally in dots per inch 
Tabs initially every # spaces 

Number of rows in each label 

Number of columns in each label 

Number of lines on a screen or a page 

Lines of memory if > lines; 0 means varies 
Number of blank characters left by smso or rmso 
Maximum number of colors on the screen 
Maximum value in micro_..._address 
Maximum value in parm_..._micro 
Maximum number of color-pairs on the screen 
Character step size when in micro mode 

Line step size when in micro mode 

Video attributes that can’t be used with colors 
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Variable 


number_of_pins 
num_labels 
output_res_char 
output_res_line 
output_res_horz_inch 
output_res_vert_inch 
padding_baud_rate 
virtual_terminal 
wide_char_size 
width_status_line 


Strings 


Variable 


acs_chars 
back_tab 

bell 
carriage_return 
change_char_pitch 
change_line_pitch 
change_res_horz 
change_res_vert 
change_scroll_region 
char_padding 
char_set_names 
clear_all_tabs 
clear_margins 
clear_screen 
elr_bol 

clr_eol 

clr_eos 
column_address 
command_character 
cursor_address 
cursor_down 
cursor_home 
cursor_invisible 
cursor_left 
cursor_mem_address 
cursor_normal 
cursor_right 
cursor_to_ll 
cursor_up 
cursor_visible 
define_char 
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Description 


Number of pins in print-head 

Number of labels on screen (start at 1) 
Horizontal resolution in units per character 
Vertical resolution in units per line 
Horizontal resolution in units per inch 
Vertical resolution in units per inch 
Lowest baud rate where padding needed 
Virtual terminal number (DYNIX/ptx) 
Char step size when in double wide mode 
Number of columns in status line 


Description 


Graphic charset pairs aAbBcC - def=vt100 
Back tab 

Audible signal (bell) 

Carriage return 

Change number of characters per inch 
Change number of lines per inch 

Change horizontal resolution 

Change vertical resolution 

Change to lines #1 through #2 (vt100) 
Like ip but when in replace mode 

List of character set names 

Clear all tab stops 

Clear all margins (top, bottom, and sides) 
Clear screen and home cursor 

Clear to beginning of line, inclusive 
Clear to end of line 

Clear to end of display 

Horizontal position absolute 

Terminal settable cmd character in prototype 
Move to row #1 col #2 

Down one line 

Home cursor (if no cup) 

Make cursor invisible 

Move left one space. 

Memory relative cursor addressing 
Make cursor appear normal (undo vs/vi) 
Non-destruct space (cursor or carriage right) 
Last line, first column (if no cup) 

Upline (cursor up) 

Make cursor very visible 

Define a character in a character set t 
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Variable 


delete_character 
delete_line 
dis_status_line 
down_half_line 
ena_acs 
enter_alt_charset_mode 
enter_am_mode 
enter_blink_mode 
enter_bold_mode 
enter_ca_mode 
enter_delete_mode 
enter_dim_mode 
enter_doublewide_mode 
enter_draft_quality 
enter_insert_mode 
enter_italics_mode 
enter_leftward_mode 
enter_micro_mode 
enter_near_letter_quality 
enter_normal_quality 
enter_protected_mode 
enter_reverse_mode 
enter_secure_mode 
enter_shadow_mode 
enter_standout_mode 
enter_subscript_mode 
enter_superscript_mode 
enter_underline_mode 
enter_upward_mode 
enter_xon_mode 
erase_chars 
exit_alt_charset_mode 
exit_am_mode 
exit_attribute_mode 
exit_ca_mode 
exit_delete_mode 
exit_doublewide_mode 
exit_insert_mode 
exit_italics_mode 
exit_leftward_mode 
exit_micro_mode 
exit_shadow_mode 
exit_standout_mode 
exit_subscript_mode 
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Description 


Delete character 

Delete line 

Disable status line 

Half-line down (forward 1/2 linefeed) 
Enable alternate character set 

Start alternate character set 

Turn on automatic margins 

Turn on blinking 

Turn on bold (extra bright) mode 
String to begin programs that use cup 
Delete mode (enter) 

Turn on half-bright mode 

Enable double wide printing 

Set draft quality print 

Insert mode (enter) 

Enable italics 

Enable leftward carriage motion 
Enable micro motion capabilities 

Set near-letter quality print 

Set normal quality print 

Turn on protected mode 

Turn on reverse video mode 

Tur on blank mode (chars invisible) 
Enable shadow printing 

Begin standout mode 

Enable subscript printing 

Enable superscript printing 

Start underscore mode 

Enable upward carriage motion 
Turn on xon/xoff handshaking 
Erase #1 characters 

End alternate character eet 

Turn off automatic margins 

Turn off all attributes 

String to end programs that use cup 
End delete mode 

Disable double wide printing 

End insert mode 

Disable italics 

Enable right (normal) carriage motion 
Disable micro motion capabilities 
Disable shadow printing 

End standout mode 

Disable subscript printing 
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Variable 


exit_superscript_mode 
exit_underline_mode 
exit_upward_mode 
exit_xon_mode 
flash_screen 
form_feed 
from_status_line 
init_lstring 
init_2string 
init_3string 
init_file 
init_prog 
initialize_color 
initialize_pair 
insert_character 
insert_line 
insert_padding 
key_al 

key_a3 

key_b2 
key_backspace 
key_beg 
key_btab 

key_cl 

key_c3 
key_cancel 
key_catab 
key_clear 
key_close 
key_command 
key_copy 
key_create 
key_ctab 

key_de 

key_dl 
key_down 
key_eic 

key_end 
key_enter 
key_eol 

key_eos 
key_exit 

key_fo 


key_fl 
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Description 


Disable superscript printing 

End underscore mode 

Enable down (normal) carriage motion 

Turn off xon/xoff handshaking 

Visible bell (may not move cursor) 

Hardcopy terminal page eject 

Return from status line 

Terminal or printer initialization string 
Terminal or printer initialization string 
Terminal or printer initialization string 
Name of initialization file 

Path name of program for initialization 
Initialize the definition of color 

Initialize color-pair 

Insert character 

Add new blank line 

Insert pad after character inserted 

KEY_AI, 0534, upper left of keypad 
KEY_A3, 0535, upper right of keypad 
KEY_B2, 0536, center of keypad 
KEY_BACKSPACE, 0407, by backspace key 
KEY_BEG, 0542, sent by beg(inning) key 
KEY_BTAB, 0541, sent by back-tab key 
KEY_C1, 0537, lower left of keypad 
KEY_C3, 0540, lower right of keypad 
KEY_CANCEL, 0543, sent by cancel key 
KEY_CATAB, 0526, sent by clear-all-tabs key 
KEY_CLEAR, 0515, by cl-screen or erase key 
KEY_CLOSE, 0544, sent by close key 
KEY_COMMAND, 0545, sent by cmd key 
KEY_COPY, 0546, sent by copy key 
KEY_CREATE, 0547, sent by create key 
KEY_CTAB, 0525, sent by clear-tab key 
KEY_DC, 0512, sent by delete-character key 
KEY_DL, 0510, sent by delete-line key 
KEY_DOWN, 0402, sent by down-arrow key 
KEY_EIC, 0514, rmir or smir in insert mode 
KEY_END, 0550, sent by end key 
KEY_ENTER, 0527, sent by enter/send key 
KEY_EOL, 0517, by clear-to-end-of-line key 
KEY_EOS, 0516, by clear-to-end-of-screen key 
KEY_EXIT, 0551, sent by exit key 
KEY_F(0), 0410, sent by function key {0 
KEY_F(1), 0411, sent by function key f1 
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Cap- Termcap 
@ Variable name Code Description 
key_f2 kf2 k2 KEY_F(2), 0412, sent by function key {2 
key_{3 kf k3 KEY_F(3), 0413, sent by function key [3 
key_f4 kf4 k4 KEY_F(4), 0414, sent by function key [4 
key_f6 kB kb KEY_F(5), 0415, sent by function key {5 
key_{6 ke k6 KEY_F(6), 0416, sent by function key {6 
key_f? kf7 k7 KEY_F(7), 0417, sent by function key {7 
key_{8 ks k8 KEY_F(8), 0420, sent by function key {8 
key_{9 Kf k9 KEY_F(9), 0421, sent by function key {9 
key_f10 kflo k KEY_F(10), 0422, sent by function key f10 
key_fll kfll Fl KEY_F(11), 0423, sent by function key f11 
key_f2 kfl2 F2 KEY_F(12), 0424, sent by function key f12 
key_f13 kfl3 F3 KEY_F(13), 0425, sent by function key f13 
key_fl4 kn4 F4 KEY_F(14), 0426, sent by function key 114 
key_f15 ks F5 KEY_F(15), 0427, sent by function key f15 
key_fl6 kflé F6 KEY_F(16), 0430, sent by function key f16 
key_f17 kfl7 F7 KEY_F(17), 0431, sent by function key [17 
key_f18 Ks F8 KEY_F(18), 0432, sent by function key 18 
key_f19 Kg Fo KEY_F(19), 0433, sent by function key f19 
key_f20 kf20 FA KEY_F(20), 0434, sent by function key [20 
key_f21 kf21 FB KEY_F(21), 0435, sent by function key [21 
key_f22 kf22 FC KEY_F(22), 0436, sent by function key [22 
key_f23 kf23 FD KEY_F(23), 0437, sent by function key [23 
key_f24 kf24 FE KEY_F(24), 0440, sent by function key f24 
key_f25 kf25 FF KEY_F(25), 0441, sent by function key [25 
key_f26 kf26 FG KEY_F(26), 0442, sent by function key [26 
key_f27 kf27 FH KEY_F(27), 0443, sent by function key [27 
key_f28 kf28 FI KEY_F(28), 0444, sent by function key [28 
key_f29 kf29 FJ KEY_F(29), 0445, sent by function key (29 
key_f30 kf30 FK KEY_F(30), 0446, sent by function key [30 
key_f31 kf31 FL KEY_F(31), 0447, sent by function key [31 
key_f32 kf32 FM KEY_F(32), 0450, sent by function key [32 


key_[33 kf3 FN KEY_F(13), 0451, sent by function key (33 


key_[34 kf34 FO KEY_F(34), 0452, sent by function key (34 
key_{85 kf35 FP KEY_F(35), 0453, sent by function key [35 
key_{86 : kf36 FQ KEY_F(36), 0454, sent by function key (36 
key_f37 kf37 FR KEY_F(37), 0455, sent by function key (37 
key_f38 kf38 FS KEY_F(38), 0456, sent by function key (88 
key_f39 kfB9 FT KEY_F(39), 0457, sent by function key [39 
key_f40 kf40 FU KEY_F(40), 0460, sent by function key [40 
key_f41 kf41 FV KEY_F(41), 0461, sent by function key [41 
key_f42 kf42 FW KEY_F(42), 0462, sent by function key [42 
key_f43 kf43 FX KEY_F(43), 0463, sent by function key [43 
key_f44 kf44 FY KEY_F(44), 0464, sent by function key [44 
key_f45 kf45 FZ KEY_F(45), 0465, sent by function key [45 


TERMINFO(4) 


Variable 


key_{46 
key_{47 
key_f48 
key_f49 
key_{60 
key_f61 
key_{52 
key_{53 
key_[64 
key_f55 
key_{56 
key_f{57 
key_(68 
key_{59 
key_f60 
key_f61 
key_{62 
key_f63 
key_find 
key_help 
key_home 
key_ic 
key_il 
key_left 
key_ll 
key_mark 
key_message 
key_move 
key_next 
key_npage 
key_open 
key_options 
key_ppage 
key_previous 
key_print 
key_redo 
key_reference 
key_refresh 
key_replace 
key_restart 
key_resume 
key_right 
key_save 
key_sbeg 
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Description 


KEY_F(46), 0466, sent by function key [46 
KEY_F(47), 0467, sent by function key f47 
KEY_F(48), 0470, sent by function key [48 
KEY_F(49), 0471, sent by function key [49 
KEY_F(50), 0472, sent by function key f50 
KEY_F(51), 0473, sent by function key f61 
KEY_F(52), 0474, sent by function key f62 
KEY_F(53), 0475, sent by function key [63 
KEY_F(54), 0476, sent by function key {64 
KEY_F(55), 0477, sent by function key [65 
KEY_F(56), 0500, sent by function key {66 
KEY_F(57), 0501, sent by function key [67 
KEY_F(58), 0502, sent by function key [68 
KEY_F(59), 0503, sent by function key [69 
KEY_F(60), 0504, sent by function key [60 
KEY_F(61), 0505, sent by function key {61 
KEY_F(62), 0506, sent by function key {62 
KEY_F(63), 0507, sent by function key [63 
KEY_FIND, 0552, sent by find key 
KEY_HELP, 0553, sent by help key 
KEY_HOME, 0406, sent by home key 
KEY_IC, 0513, by ins-char/enter ins-mode key 
KEY_IL, 0511, sent by insert-line key 
KEY_LEFT, 0404, sent by left-arrow key 
KEY_LL, 0533, sent by home-down key 
KEY_MARK, 0554, sent by mark key 
KEY_MESSAGE, 0555, sent by message key 
KEY_MOVE, 0556, sent by move key 
KEY_NEXT, 0557, sent by next-object key 
KEY_NPAGE, 0522, sent by next-page key 
KEY_OPEN, 0560, sent by open key 
KEY_OPTIONS, 0561, sent by options key 
KEY_PPAGE, 0523, sent by previous-page key 
KEY_PREVIOUS, 0562, by previous-object key 
KEY_PRINT, 0532, sent by print or copy key 
KEY_REDO, 0563, sent by redo key 
KEY_REFERENCE, 0564, by reflerence) key 
KEY_REFRESH, 0565, sent by refresh key 
KEY_REPLACE, 0566, sent by replace key 
KEY_RESTART, 0567, sent by restart key 
KEY_RESUME, 0570, sent by resume key 
KEY_RIGHT, 0405, sent by right-arrow key 
KEY_SAVE, 0571, sent by save key 
KEY_SBEG, 0572, by shifted beginning key 


DYNIX/ptx 


Variable 


key_scancel 
key_scommand 
key_scopy 
key_screate 
key_sde 
key_sdl 
key_select 
key_send 
key_seol 
key_sexit 
key_sf 
key_sfind 
key_shelp 
key_shome 
key_sic 
key_sleft 
key_smessage 
key_smove 
key_snext 
key_soptions 
key_sprevious 
key_sprint 
key_sr 
key_sredo 
key_sreplace 
key_sright 
key_srsume 
key_ssave 
key_ssuspend 
key_stab 
key_sundo 
key_suspend 
key_undo 
key_up 
keypad_local 
keypad_xmit 
lab_f0 

lab_fl 

Tab_{2 

lab_f3 

lab_f4 

lab_fS 

lab_f6 

lab_{7 


TERMINFO(4) 


Description 


KEY_SCANCEL, 0573, by shifted cancel key 
KEY_SCOMMAND, 0574, shifted command key 
KEY_SCOPY, 0575, sent by shifted copy key 
KEY_SCREATE, 0576, by shifted create key 
KEY_SDC, 0577, by shifted delete-char key 
KEY_SDL, 0600, by shifted delete-line key 
KEY_SELECT, 0601, sent by select key 
KEY_SEND, 0602, sent by shifted end key 
KEY_SEOL, 0603, sent by shifted clear-line key 
KEY_SEXIT, 0604, sent by shifted exit key 
KEY_SF, 0520, sent by scroll-forward/down key 
KEY_SFIND, 0605, sent by shifted find key 
KEY_SHELP, 0606, sent by shifted help key 
KEY_SHOME, 0607, sent by shifted home key 
KEY_SIC, 0610, sent by shifted input key 
KEY_SLEFT, 0611, by shifted left-arrow key 
KEY_SMESSAGE, 0612, by shifted message key 
KEY_SMOVE, 0613, sent by shifted move key 
KEY_SNEXT, 0614, sent by shifted next key 
KEY_SOPTIONS, 0615, by shifted options key 
KEY_SPREVIOUS, 0616, by shifted prev key 
KEY_SPRINT, 0617, by shifted print key 
KEY_SR, 0521, sent by scroll-backward/up key 
KEY_SREDO, 0620, sent by shifted redo key 
KEY_SREPLACE, 0621, by shifted replace key 
KEY_SRIGHT, 0622, by shifted night-arrow key 
KEY_SRSUME, 0623, by shifted resume key 
KEY_SSAVE, 0624, sent by shifted save key 
KEY_SSUSPEND, 0625, by shifted suspend key 
KEY_STAB, 0524, sent by set-tab key 
KEY_SUNDO, 0626, sent by shifted undo key 
KEY_SUSPEND, 0627, sent by suspend key 
KEY_UNDO, 0630, sent by undo key 

KEY_UP, 0403, sent by up-arrow key 

Out of “keypad-transmit” mode 

Put terminal in “keypad-transmit” mode 

Labels on function key (0 if not f0 

Labels on function key M if not 

Labels on function key [2 if not f2 

Labels on function key £8 if not [3 

Labels on function key f4 if not [4 

Labels on function key f5 if not 

Labels on function key {6 if not [6 

Labels on function key {7 if not {7 


TERMINFO(4) 


Variable 


lab_{® 

lab_{9 

lab_f10 

label_off 

label_on 

meta_off 

meta_on 
micro_column_address 
micro_down 
micro_left 
micro_right 
micro_row_address 
micro_up 

newline 
order_of_pins 
orig_colors 
orig_pair 
pad_char 
parm_dch 
parm_delete_line 
parm_down_cursor 
parm_down_micro 
parm_ich 
parm_index 
parm_insert_line 
parm_left_cursor 
parm_left_micro 
parm_right_cursor 
parm_right_micro 
parm_rindex 
parm_up_cursor 
parm_up_micro 
pkey_key 
pkey_local 
pkey_xmit 
plab_norm 
print_screen 
prtr_non 

prtr_off 

prtr_on 
repeat_char 
req_for_input 
reset_lstring 
Teset_2string 
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DYNIX/ptx 


Description 


Labels on function key {8 if not {8 

Labels on function key f9 if not [9 

Labels on function key f10 if not f10 
Tum off soft labels 

Turn on soft labels 

Turn off "meta mode” 

Turn on "meta mode” (8th bit) 

Like column_address for micro adjustment 
Like cursor_down for micro adjustment 
Like cursor_left for micro adjustment 
Like cursor_right for micro adjustment 
Like row_address for micro adjustment 
Like cursor_up for micro adjustment 
Newline (behaves like cr followed by If) 
Matches software bits to print-head pins 
Set all color(-pair}s to the original ones 
Set default color-pair to the original one 
Pad character (rather than null) 

Delete #1 chars 

Delete #1 lines 

Move down #1 lines. 

Like parm_down_cursor for micro adjust. 
Insert #1 blank chars 

Scroll forward #1 lines. 

Add #1 new blank lines 

Move cursor left #1 spaces 

Like parm_left_cursor for micro adjust. 
Move right #1 spaces. 

Like parm_right_cursor for micro adjust. 
Scroll backward #1 lines. 

Move cursor up #1 lines. 

Like parm_up_cursor for micro adjust. 
Prog funct key #1 to type string #2 

Prog funct key #1 to execute string #2 
Prog funct key #1 to xmit string #2 

Prog label #1 to show string #2 

Print contents of the screen 

Turn on the printer for #1 bytes 

Turn off the printer 

Turn on the printer 

Repeat char #1 #2 times 

Send next input char (for ptys) 

Reset terminal completely to sane modes 
Reset terminal completely to sane modes 


DYNIX/ptx 


Cap- 
Variable name 
reset_3string rs3 
reset_file rf 
restore_cursor re 
row_address vpa 
save_cursor BC 
scroll_forward ind 
scroll_reverse bet 
select_char_set 8c8 
set_attributes egr 
set_background setb 
set_bottom_margin smgb 
set_bottom_margin_parm smgbp 
set_color_pair scp 
set_foreground setf 
set_left_margin smgl 
set_left_margin_parm smglp 
set_right_margin smegr 
set_right_margin_parm smgrp 
set_tab hts 
set_top_margin samgt 
set_top_margin_parm emgtp 
set_window wind 
start_bit_image sbim 
start_char_set_def scad 
stop_bit_image rbim 
stop_char_set_def resd 
subscript_characters subcs 
superscript_characters supes 
tab ht 
these_cause_cr docr 
to_status_line tal 
underline_char uc 
up_half_line hu 
xoff_character xoffe 
xon_character xonc 
zero_motion zerom 
Booleans 
Cap- 
name Variable 
am - auto_right_margin 
bw auto_left_margin 
ccc can_change 
chts hard_cursor 


Termcap 
Code 


aaa 


TERMINFO(4) 


Description 


Reset terminal completely to sane modes 
Name of file containing reset string 
Restore cursor to position of last sc 
Vertical position absolute 

Save cursor position 

Scroll text up 

Scroll text down 

Select character set 

Define the video attributes #1-#9 

Set current background color 

Set bottom margin at current line 

Set bottom margin #2 lines from bottom 
Set current color-pair 

Set current foreground color] 

Set left margin at current line 

Set left (right) margin at column #1 (#2) 
Set right margin at current column 

Set right margin at column #1 

Set a tab in all rows, current column 
Set top margin at current line 

Set top (bottom) margin at line #1 (#2) 
Current window is lines #1-#2 cols #3-#4 
Start printing bit image graphics 

Start definition of a character set 

End printing bit image graphics 

End definition of a character set 

List of “subscript-able” characters 

List of “superscript-able” characters 
Tab to next 8-space hardware tab stop 
Printing any of these chars causes cr 
Go to status line, col #1 

Underscore one char and move past it 
Half-line up (reverse 1/2 linefeed) 

X-off character 

X-on character 

No motion for the subsequent character 


Description 


Terminal has automatic margins 

cub] wraps from column 0 to last column 
Terminal can re-define existing color 
Cursor is hard to see 
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TERMINFO(4) 

Cap- 

name Variable 

cpix cpi_changes_res 
crxm cr_cancels_micro_modem 
da memory_above 

daisy has_print_wheel 

db memory_below 

eo erase_overstrike 
eslok status_line_esc_ok 

gn generic_type 

he hard_copy 

his hue_lightness_saturation 
hs has_status_line 

hz tilde_glitch 

in insert_null_glitch 

km has_meta_key 

Tpix Ipi_changes_res 

mcBi prtr_silent 

mir move_insert_mode 
msgr move_standout_mode 
npe no_pad_char 

nrrmc non_rev_rmcup 

nxon needs_xon_xoff 

os over_strike 

sam semi_auto_right_margin 
ul transparent_underline 
xenl eat_newline_glitch 
xhp ceol_standout_glitch 
xhpa col_addr_glitch 

xon xon_xoff 

xsb no_esc_ctle 

xt dest_tabs_magic_smso 
xvpa row_addr_glitch 
Numbers 

Cap- 

name Variable 

bufsz buffer_capacity 
colors max_colors 

cols columns 

cps print_rate 

it init_tabs 

lh label_height 

lines lines 

Im Tines_of_memory 

lw label_width 
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Termcap 


DYNIX/ptx 


Description 


Changing character pitch changes resolution 
Using er turns off micro mode 

Display may be retained above the screen 
Printer needs operator to change character set 
Display may be retained below the screen 
Can erase overstrikes with a blank 

Escape can be used on the status line 
Generic line type (e.g., dialup, switch) 
Hardcopy terminal 

Terminal uses only HLS color notation (Tektronix) 
Has extra "status line” 

Hazeltine; can’t print tilde () 

Insert mode distinguishes nulls 

Has a meta key (shift, sets parity bit) 
Changing line pitch changes resolution 
Printer won’t echo on screen 

Safe to move while in insert mode 

Safe to move in standout modes 

Pad character doesn’t exist 

smcup does not reverse rmcup 

Padding won’t work, xon/xoff required 
Terminal overstrikes on hard-copy terminal 
Printing in last column causes cr 
Underline character overstrikes 

Newline ignored after 80 columns (Concept) 
Standout not erased by overwriting (hp) 
Only positive motion for hpa/mhpa caps 
Terminal uses xon/xoff handshaking 
Beehive (fl=escape, f2=ctrl C) 

Destructive tabs, magic smso char (t1061) 
Only positive motion for vpa/mvpa caps 


Description 


Number of bytes buffered before printing 
Maximum number of colors on the screen 
Number of columns in a line 

Average print rate in characters per second 
Tabs initially every # spaces 

Number of rows in each label 

Number of lines on a screen or a page 
Lines of memory if > lines; 0 means varies 
Number of columns in each label 


DYNIX/ptx 


Strings 
Cap- 
name 


acsc 
bel 
blink 
bold 
ebt 
chr 
civis 


Variable 


max_micro_address 
micro_col_size 
max_micro_jjump ‘ 
micro_line_size 
no_color_video 
num_labels 
number_of_pins 
output_res_char 
output_res_horz_inch 
output_res_line 
output_res_vert_inch 
max_pairs 
padding_baud_rate 
dot_horz_spacing 
dot_vert_spacing 
virtual_terminal 
wide_char_size 
width_status_line 
magic_cookic_glitch 


Varlable 


acs_chars 

bell 
enter_blink_mode 
enter_bold_mode 
back_tab 
change_res_horz 
cursor_invisible 
clear_screen 
command_character 
cursor_normal 
change_char_pitch 
carriage_return 
char_set_names 
change_scroll_region 
parm_left_cursor 
cursor_left 
parm_down_cursor 
parm_right_cursor 
cursor_right 
cursor_address 
parm_up_cursor 


Termcap 


TERMINFO(4) 


Description 


Maximum valve in micro_..._address 
Character step size when in micro mode 
Maximum value in parm_..._micro 

Line step size when in micro mode 

Video attributes that can’t be used with colors 
Number of labels on screen (start at 1) 
Number of pins in print-head 

Horizontal resolution in units per character 
Horizontal resolution in units per inch 
Vertical resolution in units per line 

Vertical resolution in units per inch 
Maximum number of color-pairs on the screen 
Lowest baud rate where padding needed 
Spacing of dots horizontally in dots per inch 
Spacing of pins vertically in pins per inch 
Virtual terminal number (DYNIX/ptx) 
Character step size when in double wide mode 
Number of columns in status line 

Number of blank characters left by smso or rmso 


Description 


Graphic charset pairs aAbBcC - def=vt100 
Audible signal (bell) 

Turn on blinking 

Turn on bold (extra bright) mode 

Back tab 

Change horizontal resolution 

Make cursor invisible 

Clear screen and home cursor 

Terminal settable cmd character in prototype 
Make cursor appear normal (undo vs/vi) 
Change number of characters per inch 
Carriage return 

List of character set names 

Change to lines #1 through #2 (vt100) 
Move cursor left #1 spaces 

Move left one space. 

Move down #1 lines. 

Move right #1 spaces. 

Non-destructive space (cursor or carriage right) 
Move to row #1 col #2 

Move cursor up #1 lines. 
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TERMINFO(4) DYNIX/ptx 


Cap- Termcap 

name Variable Code Description 

evr change_res_vert ZD Change vertical resolution 

cvvis cursor_visible : vs Make cursor very visible 

dch parm_dch DC Delete #1 chars 

dch1 delete_character de Delete character 

defe define_char ZE Define a character in a character set 

dim enter_dim_mode mh Turn on half-bright mode 

dl delete_line dll Delete line 

dl parm_delete_line DL Delete #1 lines 

do cursor_down do Down one line 

docr these_cause_cr Zw Printing any of these chars causes cr 

dsl dis_status_line ds Disable status line 

ech erase_chars ec Erase #1 characters 

ed clr_eos ed Clear to end of display 

el clr_eol ce Clear to end of line 

ell clr_bol cb Clear to beginning of line, inclusive 

enacs ena_acs eA Enable alternate character set 

fr form_feed r Hardcopy terminal page eject 

flash flash_screen vb Visible bell (may not move cursor) 

fs) from_status_line fe Return from status line 

hd down_half_line hd Half-line down (forward 1/2 linefeed) 
home cursor_home ho Home cursor (if no cup) 

hpa column_address ch Horizontal position absolute 

ht tab ta Tab to next 8-space hardware tab stop 

hts set_tab st Set a tab in all rows, current column 

hu up_half_line hu Half-line up (reverse 1/2 linefeed) 

ich parm_ich Ic Insert #1 blank chars 

ich1 insert_character ic Insert character 

if init_file if Name of initialization file 

il parm_insert_line AL Add #1 new blank lines 

ill insert_line al Add new blank line 

ind scroll_forward sf Scroll text up 

indn ‘parm_index SF Scroll forward #1 lines. 

inite initialize_color Ic Initialize the definition of color 

initp initialize_pair Ip - Initialize color-pair 

invis ‘enter_secure_mode mk Turn on blank mode (characters invisible) 
ip insert_padding ip Insert pad after character inserted 

iprog init_prog iP Path name of program for initialization 
isl init_lstring il Terminal or printer initialization string 
is2 init_2string is Terminal or printer initialization string 
is3 init_3string i3 Terminal or printer initialization string 
KBEG key_sbeg &9 KEY_SBEG, 0572, sent by shifted beginning key 
kCAN key_scancel &0 KEY_SCANCEL, 0573, sent by shifted cancel key 
kCMD key_scommand +1 KEY_SCOMMAND, 0574, sent by shifted command key 
kKCPY key_scopy *2 KEY_SCOPY, 0575, sent by shifted copy key 
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DYNIX/ptx 
Cap- 
name Variable 
kCRT key_screate 
kDC key_sde 
kDL key_sdl 
kEND key_send 
kEOL key_seol 
kKEXT key_sexit 
kFND key_sfind 
kKHLP key_shelp 
kHOM key_shome 
kIC key_sic 
kLFT key_sleft 
kMOV key_smove 
kKMSG key_smessage 
KNXT key_snext 
kOPT key_soptions 
kPRT key_sprint 
kPRV key_sprevious 
kRDO key_sredo 
.kRES key_srsume 
kRIT key_sright 
KRPL key_sreplace” 
kKSAV key_ssave 
kSPD key_ssuspend 
kUND key_sundo 
kal key_al 
kad key_a3 
kb2 key_b2 
beg key_beg 
kbs key_backspace 
kel key_cl 
ke3 key_c3 
kean key_cancel 
kebt key_btab 
kelo key_close 
kelr key_clear 
kemd key_command 
kepy key_copy 
kert Key_create 
kctab key_ctab 
keub1 key_left 
keud1 key_down 
keufl key_right 
kcuul key_up 
kdeh1 key_de 


Termcap 
Code 


+3 
04 
45 
+7 
+8 
9 
*0 
#1 
#2 
#3 


EFSFRL EP HES 


Ri 
%h 


FERRERS 


K4 


868% 


kc 
@4 


BEFFEERSS 


TERMINFO(4) 


Description 


KEY_SCREATE, 0576, sent by shifted create key 
KEY_SDC, 0577, sent by shifted delete-char key 
KEY_SDL, 0600, sent by shifted delete-line key 
KEY_SEND, 0602, sent by shifted end key 
KEY_SEOL, 0603, sent by shifted clear-line key 
KEY_SEXIT, 0604, sent by shifted exit key 
KEY_SFIND, 0605, sent by shifted find key 
KEY_SHELP, 0606, sent by shifted help key 
KEY_SHOME, 0607, sent by shifted home key 
KEY_SIC, 0610, sent by shifted input key 
KEY_SLEFT, 0611, sent by shifted left-arrow key 
KEY_SMOVE, 0613, sent by shifted move key 
KEY_SMESSAGE, 0612, sent by shifted message key 
KEY_SNEXT, 0614, sent by shifted next key 
KEY_SOPTIONS, 0615, sent by shifted options key 
KEY_SPRINT, 0617, sent by shifted print key 
KEY_SPREVIOUS, 0616, sent by shifted prev key 
KEY_SREDO, 0620, sent by shifted redo key 
KEY_SRSUME, 0623, sent by shifted resume key 
KEY_SRIGHT, 0622, sent by shifted right-arrow key 
KEY_SREPLACE, 0621, sent by shifted replace key 
KEY_SSAVE, 0624, sent by shifted save key 
KEY_SSUSPEND, 0625, sent by shifted suspend key 
KEY_SUNDO, 0626, sent by shifted undo key 
KEY_AI, 0534, upper left of keypad 

KEY_AS, 0535, upper right of keypad 

KEY_B2, 0536, center of keypad 

KEY_BEG, 0542, sent by beg{inning) key 
KEY_BACKSPACE, 0407, sent by backspace key 
KEY_C1, 0537, lower left of keypad 

KEY_C3, 0540, lower right of keypad 
KEY_CANCEL, 0543, sent by cancel key 
KEY_BTAB, 0541, sent by back-tab key 
KEY_CLOSE, 0544, sent by close key 

KEY_CLEAR, 0515, sent by clear-screen or erase key 
KEY_COMMAND, 0545, sent by cmd (command) key 
KEY_COPY, 0546, sent by copy key 

KEY_CREATE, 0547, sent by create key 
KEY_CTAB, 05265, sent by clear-tab key 

KEY_LEFT, 0404, sent by terminal left-arrow key 
KEY_DOWN, 0402, sent by terminal down-arrow key 
KEY_RIGHT, 0405, sent by terminal right-arrow key 
KEY_UP, 0403, sent by terminal up-arrow key 
KEY_DC, 0512, sent by delete-character key 
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TERMINFO(4) DYNIX/ptx 


Cap- Termcap 

name Variable Code Description 

kdll key_dl kL KEY_DL, 0510, sent by delete-line key 
ked key_eos ked KEY_EOS, 0516, sent by clear-to-end-of-screen key 
kel key_eol kE KEY_EOL, 0517, sent by clear-to-end-of-line key 
kend key_end @7 KEY_END, 0550, sent by end key 

kent key_enter @8 KEY_ENTER, 0527, sent by enter/send key 
kext key_exit @9 KEY_EXIT, 0551, sent by exit key 

kf key_f0 ko KEY_F(0), 0410, sent by function key f0 
kfl key_fl kl KEY_F(1), 0411, sent by function key fl 
kf10 key_f10 k KEY_F(10), 0422, sent by function key {10 
kf11 key_f11 Fl KEY_F(11), 0423, sent by function key f11 
kf2 key_f12 F2 KEY_F(12), 0424, sent by function key f12 
Kf3 key_f13 F3 KEY_F(13), 0425, sent by function key [13 
kf4 key_fl4 F4 KEY_F(14), 0426, sent by function key f14 
ks key_f15 F5 KEY_F(15), 0427, sent by function key f15 
kfl6é key_f16 F6 KEY_F(16), 0430, sent by function key 116 
kfl7 key_f17 F7 KEY_F(17), 0431, sent by function key f17 
kf1g key_f18 F8 KEY_F(18), 0432, sent by function key f18 
kfg key_f19 F9 KEY_F(19), 0433, sent by function key f19 
kf2 key_{2 k2 KEY_F(2), 0412, sent by function key [2 
kf20 key_f20 FA KEY_F(20), 0434, sent by function key [20 
kf21 key_f21 FB KEY_F(21), 0435, sent by function key [21 
kf22 key_f22 FC KEY_F(22), 0436, sent by function key [22 
kf23 key_{23 FD KEY_F(23), 0437, sent by function key [23 
kf24 key_{24 FE KEY_F(24), 0440, sent by function key [24 
kf25 key_(25 FF KEY_F(25), 0441, sent by function key [25 
kf26 key_{26 FG KEY_F(26), 0442, sent by function key [26 
kf27 key_{27 FH KEY_F(27), 0443, sent by function key [27 
kf28 key_f28 FI KEY_F(28), 0444, sent by function key [28 
kf29 key_{29 FJ KEY_F(29), 0445, sent by function key [29 
ks key_{3 k3 KEY_F(3), 0413, sent by function key [3 
kf30 key_f30 FK KEY_F(30), 0446, sent by function key [30 
kf31 key_f31 FL KEY_F(31), 0447, sent by function key [31 
kf32 key_f32 FM KEY_F(32), 0450, sent by function key [32 
k33 key_f33 FN KEY_F(13), 0451, sent by function key 33 
kf34 key_(34 FO KEY_F(34), 0452, sent by function key [34 
kf35 key_f35 FP KEY_F(35), 0453, sent by function key [35 
kf36 key_f36 FQ KEY_F(36), 0454, sent by function key (86 
kf37 key_(37 FR KEY_F(37), 0455, sent by function key {37 
kf38 key_(38 FS KEY_F(38), 0456, sent by function key [38 
kf39 key_f39 FT KEY_F(39), 0457, sent by function key [39 
kf4 key_f4 k4 KEY_F(4), 0414, sent by function key f4 
kf40 key_f40 FU KEY_F(40), 0460, sent by function key [40 
kf4l key_{41 FV KEY_F(41), 0461, sent by function key f41 
kf42 key_f42 FW KEY_F(42), 0462, sent by function key [42 
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DYNIX/ptx TERMINFO(4) 


Cap- Termcap 

om) name Variable Code Description 
kf43 key_f43 FX _ KEY_F(43), 0463, sent by function key [43 
kf44 key_f44 FY KEY_F(44), 0464, sent by function key [44 
kf45 key_f45 FZ KEY_F(45), 0465, sent by function key [45 
kf46 key_f46 Fa KEY_F(46), 0466, sent by function key [46 
kf47 key_f47 Fb KEY_F(47), 0467, sent by function key [47 


kf4s key_f48 Fe KEY_F(48), 0470, sent by function key [48 


kf49 key_f49 Fda KEY_F(49), 0471, sent by function key [49 
kp key_f{5 kB KEY_F(5), 0415, sent by function key [6 
kfG0 key_f50 Fe KEY_F(50), 0472, sent by function key [60 
kf1 key_f51 Ff KEY_F(51), 0473, sent by function key [61 
k52 key_(62 Fg KEY_F(52), 0474, sent by function key [52 
kfS3. key_{63 Fh KEY_F(53), 0475, sent by function key [53 
kfS4 key_f64 Ki KEY_F(54), 0476, sent by function key [64 
kfS5 key_f65 KR KEY_F(55), 0477, sent by function key [65 
kf6 key_f56 Fk KEY_F(56), 0500, sent by function key (56 
kf57 key_{67 Fl KEY_F(57), 0501, sent by function key [67 
ks key_f68 Fm KEY_F(658), 0502, sent by function key [68 
kf69 key_f{69 Fn KEY_F(59), 0503, sent by function key {69 
kf6 key_f6 k6 KEY_F(6), 0416, sent by function key {6 
kf60 key_f60 Fo KEY_F(60), 0504, sent by function key {60 
kf61 key_f61 Fp KEY_F(61), 0505, sent by function key [61 
kf62 key_f62 Fq KEY_F(62), 0506, sent by function key [62 
kf63 key_f63 Fr KEY_F(63), 0507, sent by function key [63 
kf7 key_f7 k7 KEY_F(7), 0417, sent by function key [7 
Kf key_f8 k8& KEY_F(8), 0420, sent by function key [8 
kp key_f9 k9 KEY_F(9), 0421, sent by function key [9 
kfnd key_find @0 KEY_FIND, 0552, sent by find key 

khip key_help %1 KEY_HELP, 0553, sent by help key 

khome key_home kh KEY_HOME, 0406, sent by home key 
khts key_stab kT KEY_STAB, 0524, sent by set-tab key 
Kich1 key_ic kl KEY_IC, 0513, sent by ins-char/enter ins-mode key 
kill key_il KA KEY_IL, 0511, sent by insert-line key 
kind key_sf kF KEY_SF, 0520, sent by scroll-forward/down key 
kil key kH KEY_LL, 0533, sent by home-down key 
kmov key_move %4 KEY_MOVE, 0556, sent by move key 
kmrk key_mark 2 KEY_MARK, 0554, sent by mark key 
kmsg key_message %3 KEY_MESSAGE, 0555, sent by message key 
knp key_npage kN KEY_NPAGE, 0522, sent by next-page key 
knxt key_next WS KEY_NEXT, 0557, sent by next-object key 


kopn key_open 6 KEY_OPEN, 0560, sent by open key 


kopt key_options 7 KEY_OPTIONS, 0561, sent by options key 

kpp key_ppage kP KEY_PPAGE, 0523, sent by previous-page key 

kprt key_print 9 KEY_PRINT, 0532, sent by print or copy key 

kprv key_previous %8 KEY_PREVIOUS, 0562, sent by previous-object key 
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Cap- 

name Variable 

kerdo key_redo 

kref key_reference 
kres key_resume 

ofr key_refresh 

ki key_sr 

iemir key_eic 

krpl key_replace 

inst key_restart 

ksav key_save 

kslt key_select 

kspd key_suspend 

ktbe key_catab 

kund key_undo 

1f0 lab_f0 

1fl lab_fl 

1110 lab_f10 

1f2 lab_f2 

168 lab_fa 

1f4 lab_f4 

1s lab_{S 

1f6 lab_{6 

17 lab_{7 

16 lab_{8 

19 lab_f9 

ll cursor_to_]] 

lpi change_line_pitch 
mcO print_screen 

mc4 prtr_off 

mc5 prtr_on 

mec5Sp prtr_non 

meub parm_left_micro 
meub1 micro_left 

mcud parm_down_micro 
mceud1 micro_down 

meuf parm_right_micro 
meufl micro_right 

mecuu parm_up_micro 
mcuul micro_up 

mge clear_margins 
mhpa micro_column_address 
mrcup cursor_mem_address 
mvpa micro_row_address 
nel newline 

oc orig_colors 
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Description 


KEY_REDO, 0563, sent by redo key 
KEY_REFERENCE, 0564, sent by ref{erence) key 
KEY_RESUME, 0570, sent by resume key 
KEY_REFRESH, 0565, sent by refresh key 
KEY_SR, 0521, sent by scroll-backward/up key 
KEY_EIC, 0514, sent by rmir or smir in insert mode 
KEY_REPLACE, 0566, sent by replace key 
KEY_RESTART, 0567, sent by restart key 
KEY_SAVE, 0571, sent by save key 
KEY_SELECT, 0601, sent by select key 
KEY_SUSPEND, 0627, sent by suspend key 
KEY_CATAB, 0526, sent by clear-all-tabe key 
KEY_UNDO, 0630, sent by undo key 

Labels on function key 0 if not f0 

Labels on function key f1 if not f1 

Labels on function key 10 if not [10 

Labels on function key f2 if not f2 

Labels on function key £3 if not f3 

Labels on function key f4 if not {4 

Labels on function key {6 if not {6 

Labels on function key £6 if not {6 

Labels on function key {7 if not {7 

Labels on function key {8 if not {8 

Labels on function key f9 if not [9 

Last line, first column (if no cup) 

Change number of lines per inch 

Print contents of the screen 

Turn off the printer 

Turn on the printer 

Turn on the printer for #1 bytes 

Like parm_left_cursor for micro adjust. 
Like cursor_left for micro adjustment 

Like parm_down_cursor for micro adjust. 
Like cursor_down for micro adjustment 
Like parm_right_cursor for micro adjust. 
Like cursor_right for micro adjustment 
Like parm_up_cursor for micro adjust. 
Like cursor_up for micro adjustment) 
Clear all margins (top, bottom, and sides) 
Like column_address for micro adjustment 
Memory relative cursor addressing 

Like row_address for micro adjustment 
Newline (behaves like cr followed by If) 

Set all color(-pair}s to the original ones 
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Variable 

orig_pair 

pad_char 

pkey_key 

pkey_local 
pkey_xmit 
plab_norm 
order_of_pins 
enter_protected_mode 
stop_bit_image 
restore_cursor 
stop_char_set_def 
repeat_char 
enter_reverse_mode 
reset_file 
req_for_input 
scroll_reverse 
parm_rindex 
exit_italics_mode 
exit_leftward_mode 
exit_alt_charset_mode 
exit_am_mode 
exit_ca_mode 
exit_delete_mode 
exit_micro_mode 
exit_insert_mode 
keypad_local 
label_off 

meta_off 
char_padding 
exit_standout_mode 
exit_underline_mode 
exit_xon_mode 
reset_lstring 
reset_2string 
reset_3string 
exit_shadow_mode 
exit_subscript_mode 
exit_superscript_mode 
exit_upward_mode 
exit_doublewide_mode 
start_bit_image 
save_cursor 
set_color_pair 
select_char_set 


Termcap 
Code 
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Description 


Set default color-pair to the original one 
Pad character (rather than null) 

Prog funct key #1 to type string #2 

Prog funct key #1 to execute string #2 
Prog funct key #1 to xmit string #2 

Prog label #1 to show string #2 

Matches software bits to print-head pins 
Turn on protected mode 

End printing bit image graphics 

Restore cursor to position of last sc 

End definition of a character set 

Repeat char #1 #2 times 

Tum on reverse video mode 

Name of file containing reset string 
Send next input char (for ptys) 

Scroll text down 

Scroll backward #1 lines. 

Disable italics 

Enable rightward (normal) carriage motion 
End alternate character set 

Turn off automatic margins 

String to end programs that use cup 
End delete mode 

Disable micro motion capabilities 

End insert mode 

Out of “keypad-transmit” modey 

Turn off soft labels 

Turn off "meta mode” 

Like ip but when in replace mode 

End standout mode 

End underscore mode 

Turn off xon/xoff handshaking 

Reset terminal completely to sane modes 
Reset terminal completely to sane modes 
Reset terminal completely to sane modes 
Disable shadow printing 

Disable subscript printing 

Disable superscript printing 

Enable downward (normal) carriage motion 
Disable double wide printing 

Start printing bit image graphics 

Save cursor position 

Set current color-pair 

Select character set 
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Cap- 
name 


BcaC 
sdriq 
setb 
setf 


sitm 


smcup 
smdc 


smgb 


smgl 
smglp 
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Variable 


start_char_set_def 
enter_draft_quality 
set_background 
set_foreground 
set_attributes 
exit_attribute_mode 
enter_italics_mode 
enter_leftward_mode 
enter_alt_charset_mode 
enter_am_mode 
enter_ca_mode 
enter_delete_mode 
set_bottom_margin 
set_bottom_margin_parm 
set_left_margin 
set_left_margin_parm 
set_right_margin 
set_right_margin_parm 
set_top_margin 
set_top_margin_parm 
enter_micro_mode 
enter_insert_mode 
keypad_xmit 

label_on 

meta_on 
enter_standout_mode 
enter_underline_mode 
enter_xon_mode 
enter_near_letter_quality 
enter_normal_quality 
enter_shadow_mode 
enter_subscript_mode 
enter_superscript_mode 
subscript_characters 
enter_upward_mode 
superscript_characters 
enter_doublewide_mode 
clear_all_tabs 
to_status_line 
underline_char 
cursor_up 

row_address 
set_window 
xoff_character 
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Description 


Start definition of a character set 

Set draft quality print 

Set current background color 

Set current foreground color 

Define the video attributes #1-#9 
Turn off all attributes 

Enable italics 

Enable leftward carriage motion 

Start alternate character set 

Turn on automatic margins 

String to begin programs that use cup 
Delete mode (enter) 

Set bottom margin at current line 

Set bottom margin at line #1 or #2 lines from bottom 
Set left margin at current line 

Set left (right) margin at column #1 (#2) 
Set right margin at current column 
Set right margin at column #1 

Set top margin at current line 

Set top (bottom) margin at line #1 (#2) 
Enable micro motion capabilities 
Insert mode (enter) 

Put terminal in “keypad-transmit” mode 
Turn on soft labels 

Turn on “meta mode” (8th bit) 

Begin standout mode 

Start underscore mode 

Tur on xon/xoff handshaking 

Set near-letter quality print 

Set normal quality print 

Enable shadow printing 

Enable subscript printing 

Enable superscript printing 

List of “subscript-able” characters 
Enable upward carriage motion 

List of “superscript-able” characters 
Enable double wide printing 

Clear all tab stops 

Go to status line, col #1 

Underscore one char and move past it 
Upline (cursor up) 

Vertical position absolute 

Current window is lines #1-#2 cols #3-#4 
X-off character 
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Cap- Termcap 

name Variable Code Description 

xonc xon_character XN X-on character 

zerom zero_motion zx No motion for the subsequent character 
EXAMPLE 


The following entry, which describes the AT&T 610 terminal, is one of the 
most complex entries in the terminfo file. 


610 | 610bct | ATT610 | att 610 | AT&T 610; 80column; 98key keyboard 
am, eslok, hs, mir, msgr, xenl, xon, 
cols#80, it#8, lh#2, lines#24, lw#8, nlab#8, wsl#80, 
acsc=*‘‘aaffggjjkkllmmnnooppqarrssttuuvvwwxxyyzz{{ | | }}77, 
bel="G, blink=\E[{5m, bold=\E[1lm, cbt=\E[Z, 
civis=\E[?251, clear=\E(H\E[J, cnorm=\E[?25h\E[?121, 
er=\r, csr=\E(%itpltd;%p2%dr, cub=\E[%pl%dD, cubl=\b, 
cud=\E[%p1%dB, cudl=\E(B, cuf=\E[%pl%dc, cufl=\E[C, 
cup=\E[%itp1%d;%p2%dH, cuu=\E[%pl%dA, cuul=\E[A, 
evvis=\E[?12;25h, dch=\E[%p1%dP, dchl=\E[P, dim=\E[2m, 
dl=\E[%p1%dM, dll=\E[M, ed=\E[J, el=\E[K, el1l=\E[1K, 
flash=\E[?5h$<200>\E[?51, fsl=\E8, home=\E[H, ht=\t, 
ich=\E[%p1%d@, il=\E[%pl%dL, il1=\E[L, ind=\ED, 
invis=\E[8m, 
isl=\E(8;0 | \E[?3;4;75;13;151\E(13;201\E[?7h\E[12h\E (B\E) 0, 
is2=\E[Om*0O, is3=\E(B\E)0, kLFT=\E[\s@, kRIT=\E[\sA, 
kbs=\b, kebt=\E[Z2, kclr=\E[2J, kcubl=\E[D, kcudl=\E[B, 
keuf1l=\E[C, kcuvl=\E[A, kfl=\EOc, kf10=\ENp, 
kf11=\ENq, kf£12=\ENr, kf13=\ENs, kf14=\ENt, kf2=\EOd, 
kf3=\E0e, kf£f4=\EOf, kfS=\EOg, kf6=\EOh, kf7=\EOi, 
kf8=\EOj, kf£9=\ENo, khome=\E[H, kind=\E[S, kri=\E[T, 
11l=\E(24H, mc4=\E(?4i, mc5=\E[?5i, nel=\EE, | 
pfx=\E(%p1%d; %p2%1%02dq\s\s\sF%pl%1d\s\s\s\s\s 

\s\s\s\s\s\stp2%s, 
pln=\E[%p1%d; 0; 0; 0q%p2%:-16.16s, rc=\E8, rev=\E[7m, 
ri=\EM, rmacs="0O, rmir=\E[4l, rmln=\E[2p, rmso=\E[m, 
rmul=\E[(m, rs2=\Ec\E[?3l, sc=\E7, 
sgr=\E[0%?$p6%t;1%7B2$pS8t; 2%; $2bp2tt; 4%; $2tpase; 5%; 

S$?Ep3tp1s | $c; 7%; S2%p7%t; 8%; mb27bpIst “Nte “Ot; 
sgr0=\E[m*0, smacs="N, smir=\E[(4h, smln=\E[p, 
smso=\E[7m, smul=\E[4m, tsl=\E7\E(25;%itpl%dx, 


Types of Capabilities in the Sample Entry 
The example shows the formats for the three types of terminfo capabilities: 
Boolean, numeric, and string. All capabilities specified in the terminfo source 
file must be followed by commas, including the last capability in the source 
file. 
Capabilities are referenced by their capability names (as shown in the previ- 
ous tables). Boolean capabilities are specified simply by their comma 
separated cap names. 
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Numeric capabilities are followed by the character ‘# and then a positive inte- 
ger value. Thus, in the sample, cols (which shows the number of columns 
available on a device) is assigned the value 80 for the AT&T 610. (Values for 
numeric capabilities may be specified in decimal, octal or hexadecimal, using 
normal C conventions.) 


Finally, string-valued capabilities such as el (clear to end of line sequence) are 
listed by a two- to five-character cap name, an ‘=’, and a string ended by the 
next comma. A delay in milliseconds may appear anywhere in such a capabil- 
ity, enclosed in $<..> brackets, as in el= \EK$<3>. Padding characters are 
supplied by tputs(). The delay can be any of the following: a number (5), a 
number followed by a ‘*’ (5*), a number followed by a / (5/, or a number fol- 
lowed by both (5+*/). A ‘*’ shows that the padding required is proportional to 
the number of lines affected by the operation, and the amount given is the per- 
affected-unit padding required. (In the case of insert characters, the factor is 
still the number of lines affected. This is always 1 unless the device has in 
and the software uses it.) When a ‘*’ is specified, it is sometimes useful to give 
a delay of the form 3.5 to specify a delay per unit to tenths of milliseconds. 
Only one decimal place is allowed. 


A slash / indicates that the padding is mandatory. Ifa device has xon 
defined, the padding information is advisory and is only used for cost esti- 
mates or when the device is in raw mode. Mandatory padding is transmitted 
regardless of the setting of xon. If padding (whether advisory or mandatory) 
is specified for bel or flash, however, it is always used, regardless of whether 
xon is specified. 


terminfo offers notation for encoding special characters. Both \E and \e map 
to an ESCAPE character, “x maps to a control-x for any appropriate x, and the 
sequences \n, \J, \r, \t, \b, \f, and \s give a newline, linefeed, return, tab, 
backspace, formfeed, and space, respectively. Other escapes include: \* for 
caret (*); \\ for backslash (\); \, for comma (,); \: for colon (:); and \0 for null. 
(\0 will actually produce \200, which does not terminate a string but behaves 
as a null character on most devices, providing CS7 is specified. (See stty(1).) 
Finally, characters may be given as three octal digits after a backslash, for 
example \123 

Sometimes individual capabilities must be commented out. Capabilities are 
defined in a left-to-right order, therefore, a prior definition overrides a later 
definition. To comment out a capability, put a period before the capability 
name. 


Preparing Descriptions 
The most effective way to prepare a device description is by imitating the 
description of a similar device in terminfo and building up a description gradu- 
ally, testing partial descriptions with vi(1) to make sure that they are correct. 
A very unusual device may expose deficiencies in the ability of the terminfo file 
to describe it, or with the ability of vi(1) to work with that device. To testa 
new device description, set the environment variable TERMINFO to the path- 
name of a directory containing the compiled description you are working on so 
that programs look there rather than in /usr/lib/terminfo. To get the pad- 
ding for insert-line correct (if the device manufacturer did not document it) a 
severe test is to comment out xon, edit a large file at 9600 baud with vi(1), 
delete 16 or so lines from the middle of the screen, and then hit the u key 
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several times quickly. If the display is corrupted, more padding is usually 
& needed. A similar test can be used for insert-character. 


Section 1-1 Basic Capabilities 
The number of columns on each line for a device is given by the cols numeric 
capability. Ifthe device has a screen, the number of lines on the screen is 
indicated by the lines capability. If the device wraps around to the beginning 
of the next line when it reaches the right margin, it should have the am capa- 
bility. 
If the terminal can clear its screen, leaving the cursor in the home position, 
the clear string capability is used. If the terminal overstrikes (rather than 
clearing a position when a character is struck over) it should have the os 
capability. If the device is a printing terminal, with no soft copy unit, specify 
both he and os. If there is a way to move the cursor to the left edge of the cur- 
rent row, specify this as cr. (Normally this will be carriage return, control M.) 
If there is a way to produce an audible signal, such as a bell or a beep, specify 
it as bel. If, like most devices, the device uses the xon-xoff flow-control proto- 
col, specify xon. 


If there is a way to move the cursor one position to the left, such as backspace, 
that capability should be given as cubl Similarly, sequences to move to the 
right, up, and down should be given as cufl, cuul, and cud], respectively. 
These local cursor motions must not alter the text they pass over; for example, 
you would not normally use “cufl=\s” because the space would erase the 
character moved over. 


@ NOTE: A very important point here is that the local cursor motions encoded in 
terminfo are undefined at the left and top edges of a screen terminal. Pro- 
grams should never attempt to backspace around the left edge, unless bw is 
specified, and should never attempt to go up locally off the top. To scroll text 
up, a program goes to the bottom left corner of the screen and sends the ind 
(index) string. 


To scroll text down, a program goes to the top left corner of the screen and 
sends the ri (reverse index) string. The strings ind and ri are undefined 
when not on their respective corners of the screen. 


Parameterized versions of the scrolling sequences are indn and rin. These 
versions have the same semantics as ind and ri, except that they take one 
parameter and scrol] the number of lines specified by that parameter. They 
are also undefined except at the appropriate edge of the screen. 


The am capability tells whether the cursor sticks at the right edge of the 
screen when text is output, but this does not necessarily apply to a cufl from 
the last column. Backward motion from the left edge of the screen is possible 
only when bw is specified. In this case, cub1 moves to the right edge of the 
previous row. If bw is not given, the effect is undefined. This is useful for 
drawing a box around the edge of the screen, for example. If the device has 
switch-selectable automatic margins, am should be specified in the terminfo 
source file. In this case, initialization strings should turn on this option, if 
possible. If the device has a command that moves to the first column of the 
next line, that command can be given as nel (newline). It does not matter if 
© the command clears the remainder of the current line, so if the device has no 
cr and If it may still be possible to make a working nel out of one or both of 
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them. 
These capabilities suffice to describe hardcopy and screen terminals. Thus the & 
AT&T 5320 hardcopy terminal is described as follows: 


5320 |att5320|AT&T 5320 hardcopy terminal, 


am, hc, os, 
cols#132, 


bel="G, cr=\r, cubl=\b, cndl=\n, 
dchl=\E[P, dl1l=\E[M, 


ind=\n, 


while the Lear Siegler ADM-3 is described as 


adm3 | 1lsi adm3, 


am, bel="G, clear="Z, cols#80, cr="M, cubl=“"H, 
cudl="J, ind=*d, lines#24, 
Section 1-2 Parameterized Strings 

Cursor addressing and other strings requiring parameters are described by a 
parameterized string capability, with printf(3S)-like escapes (%x) in it. For 
example, to address the cursor, the cup capability is given, using two parame- 
ters: the row and column to address to. (Rows and columns are numbered 
from zero and refer to the physical screen visible to the user, not to any 
unseen memory.) If the terminal has memory-relative cursor ad dxGaeing, it 
can be indicated by mreup. 


The parameter mechanism uses a stack and special % codes to manipulate the 


stack in the manner of Reverse Polish Notation (postfix). Typically a sequence 
pushes one of the parameters onto the stack and then prints it in some format. 
Often more complex operations are necessary. Operations are in postfix form 


with the operands in the usual order. That is, to subtract 5 from the first 
parameter, one would use %p1%{5}%-. 


The % encodings have the following meanings: 


%% 


outputs ‘%’ 


%[:Ylags[width[. precision]][doxXs] 


Tor 


%pl{1-9] 
%Pla-z) 
%gla-z] 
qc’ 

% {nn} 
%\ 


Yor To— Yo Yol Yorn 


%& Jo\ Gor 
Jo= To> To< 
%A%O 

%\ To 

%i 


as in printf, flags are [-+#] and space 
print pop() gives %c 


push ith parm 

set variable [a-z] to pop() 

get variable [a-z] and push it 
push char constant c 

push decimal constant nn 
push strlen(pop()) 


arithmetic (%m is mod): push(pop integer2() op pop integer1()) 
bit operations: push(pop integer2() op pop integer1()) 
logical operations: push(pop() op pop()) 
logical operations: and, or 
unary operations: push(op pop()) & 
(for ANSI terminals) 
add 1 to first parm, if one parm present, 
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several times quickly. If the display is corrupted, more padding is usually 
needed. A similar test can be used for insert-character. 


Section 1-1 Basic Capabilities 


The number of columns on each line for a device is given by the cols numeric 
capability. If the device has a screen, the number of lines on the screen is 
indicated by the lines capability. If the device wraps around to the beginning 
of the next line when it reaches the right margin, it should have the am capa- 
bility. 

If the terminal can clear its screen, leaving the cursor in the home position, 
the clear string capability is used. If the terminal overstrikes (rather than 
clearing a position when a character is struck over) it should have the os 
capability. If the device is a printing terminal, with no soft copy unit, specify 
both he and os. If there is a way to move the cursor to the left edge of the cur- 
rent row, specify this as cr. (Normally this will be carriage return, control M.) 
If there is a way to produce an audible signal, such as a bell or a beep, specify 
jt as bel. If, like most devices, the device uses the xon-xoff flow-control proto- 
col, specify xon. 


If there is a way to move the cursor one position to the left, such as backspace, 
that capability should be given as cubl. Similarly, sequences to move to the 
right, up, and down should be given as cufl, cuul, and cud1, respectively. 
These local cursor motions must not alter the text they pass over; for example, 
you would not normally use “cufl=\s” because the space would erase the 
character moved over. 


NOTE: A very important point here is that the local cursor motions encoded in 
terminfo are undefined at the left and top edges of a screen terminal. Pro- 
grams should never attempt to backspace around the left edge, unless bw is 
specified, and should never attempt to go up locally off the top. To scroll text 
up, @ program goes to the bottom left corner of the screen and sends the ind 
(index) string. 


To scroll text down, a program goes to the top left corner of the screen and 
sends the ri (reverse index) string. The strings ind and ri are undefined 
when not on their respective corners of the screen. 


Parameterized versions of the scrolling sequences are indn and rin. These 
versions have the same semantics as ind and ri, except that they take one 
parameter and scroll the number of lines specified by that parameter. They 
are also undefined except at the appropriate edge of the screen. 


The am capability tells whether the cursor sticks at the right edge of the 
screen when text is output, but this does not necessarily apply to a cufl from 
the last column. Backward motion from the left edge of the screen is possible 
only when bw is specified. In this case, cubl moves to the right edge of the 
previous row. If bw is not given, the effect is undefined. This is useful for 
drawing a box around the edge of the screen, for example. If the device has 
switch-selectable automatic margins, am should be specified in the terminfo 
source file. In this case, initialization strings should turn on this option, if 
possible. If the device has a command that moves to the first column of the 
next line, that command can be given as nel (newline). It does not matter if 
the command clears the remainder of the current line, so if the device has no 
cr and If it may still be possible to make a working nel out of one or both of 
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them. 


These capabilities suffice to describe hardcopy and screen terminals. Thus the 
AT&T 5320 hardcopy terminal is described as follows: 


5320 |att5320|/AT&T 5320 hardcopy terminal, 
am, hc, os, 
cols#132, 
bel="G, cr=\r, cubl=\b, cndl=\n, 
dchl=\E[P, dl1=\E[M, 
ind=\n, 


while the Lear Siegler ADM-3 is described as 


adm3|1lsi adm3, 
am, bel="G, clear="Z, cols#80, cr="M, cubl="H, 
cudl="J, ind="J, lines#24, 
Section 1-2 Parameterized Strings 

Cursor addressing and other strings requiring parameters are described by a 
parameterized string capability, with printf(3S)-like escapes (%x) in it. For 
example, to address the cursor, the cup capability is given, using two parame- 
ters: the row and column to address to. (Rows and columns are numbered 
from zero and refer to the physical screen visible to the user, not to any 


unseen memory.) If the terminal has memory-relative cursor addressing, it 
can be indicated by mreup. 


The parameter mechanism uses a stack and special % codes to manipulate the 
stack in the manner of Reverse Polish Notation (postfix). Typically a sequence 
pushes one of the parameters onto the stack and then prints it in some format. 
Often more complex operations are necessary. Operations are in postfix form 
with the operands in the usual order. That is, to subtract 5 from the first 
parameter, one would use %p1%[5}%-. 


The % encodings have the following meanings: 


%%0 outputs ‘%’ 
MI (:Ylags][width[.precision]][doxXs] 
as in printf, flags are [-++#] and space 


Toa print pop() gives %c 
%pl1-9] push ith parm 
%P[a-z] set variable [a-z] to pop() 
%gla-z] get variable [a-z] and push it 
%'c’ push char constant c 
%{nn} push decimal constant nn 
%\ push strlen(pop()) 
%o+ To— Tox Tol Yorn 
arithmetic (%m is mod): push(pop integer2() op pop integer1()) 
%& %o\ %" bit operations: push(pop integer2() op pop integer1()) 
Jo= To> Tox logical operations: push(pop() op pop()) 
%A%O logical operations: and, or 
To To unary operations: push(op pop()) @ 
%i (for ANSI terminals) 


add 1 to first parm, if one parm present, 
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or first two parms, if more than one parm present 


& %? expr %t thenpart %e elsepart %; 
if-then-else, %e elsepart is optional; 
else-if's are possible ala Algol 68: 
%? c. Mtb. Mec, Mtb, Mec, Mtb, Mec, Ztb, Me b.%; 
0 H 
c are conditions, b, are bodies. : ? $ 


If the — flag is used with %[doxXs], then a colon (:) must be placed between 
the % and the — to differentiate the flag from the binary %- operator, for 
example %:-16.16s 


Consider the Hewlett-Packard 2645, which, to get to row 3 and column 12, 
needs to be sent \E&a12c03Y padded for 6 milliseconds. Note that the order 
of the rows and columns is inverted here, and that the row and column are 
zero-padded as two digits. Thus its cup capability is 

cup=\E &a%p2%2.2dce%p1%2.2dY$<6>. 


The Micro-Term ACT-IV needs the current row and column sent preceded by a 
“T, with the row and column simply encoded in binary, like this: 
cup="T%p1%c%p2%c. Devices that use %c need to be able to backspace the 
cursor (cub]), and to move the cursor up one line on the screen (cuul). This is 
necessary because it is not always safe to transmit \n, “D, and \r, as the sys- 
tem may change or discard them. (The library routines dealing with terminfo 
set tty modes so that tabs are never expanded, so \t is safe to send. This is 
a) essential for the Ann Arbor 4080.) 


A final example is the LSI ADM-3a, which uses row and column offset by a 
blank character, like this: cup=\E=%p1%'\s’"%+%c%p2% \s'%+%c. Sending 
\E= pushes the first parameter, pushes the ASCII value for a space (32), adds 
them (pushing the sum on the stack in place of the two previous values), and 
outputs that value as a character. Then the same is done for the second 
parameter. More complex arithmetic is possible using the stack. 


Section 1-3 Cursor Motions 
If the terminal has a fast way to return the cursor to the very upper left cor- 
ner of screen, this can be given as home. Similarly, a fast way of getting to 
the lower left-hand corner can be given as ll; this may involve going up with 
cuul from the home position, but a program should never do this itself (unless 
ll does) because it can make no assumption about the effect of moving up from 
the home position. The home position is the same as addressing to (0,0): to 
the top left corner of the screen, not of memory. Thus, the \EH sequence on 
Hewlett-Packard terminals cannot be used for home without losing some of 
the other features on the terminal. 


If the device has row or column absolute-cursor addressing, these can be given 
as single parameter capabilities hpa (horizontal position absolute) and vpa 
(vertical position absolute). Sometimes these are shorter than the more gen- 
eral two-parameter sequence (as with the Hewlett-Packard 2645) and can be 
used in preference to cup. If there are parameterized local motions (for 
example, move n spaces to the right) these can be given as cud, cub, cuf, and 
© cuu with a single parameter indicating how many spaces to move. These are 
primarily useful if the device does not have cup, such as the Tektronix 4025. 
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If the device needs to be in a special mode when running a program that uses 
these capabilities, the codes to enter and exit this mode can be given as 
smceup and rmcup. This arises, for example, from terminals, such as the 
Concept, with more than one page of memory. If the device has only memory 
relative cursor addressing and not screen relative cursor addressing, a one 
screen-sized window must be fixed into the device for cursor addressing to 
work properly. This is also used for the Tektronix 4025, where smcup sets 
the command character to be the one used by terminfo. If the smcup 
sequence will not restore the screen after an rmcup sequence is output (to the 
state prior to outputting rmcup), specify nrrme. 


Section 1-4 Area Clears 
If the terminal can clear from the current position to the end of the line, leav- 
ing the cursor where it is, indicate this with el. If the terminal can clear from 
the beginning of the line to the current position inclusive, leaving the cursor 
where it is, indicate this with ell Ifthe terminal can clear from the current 
position to the end of the display, indicate this with ed. ed is only defined 
from the first column of a line. (Thus, it can be simulated by a request to 
delete a large number of lines,-if a true ed is not available.) 


Section 1-5 Insert/Delete Line 
If the terminal can open a new blank line before the line where the cursor is, 
indicate this with ill; this is done only from the first position of a line. The 
cursor must then appear on the newly blank line. If the terminal can delete 
the line which the cursor is on, indicate this with dll; this is done only from 
the first position on the line to be deleted. Versions of ill and dll which take a 
single parameter, and insert or delete that many lines, can be given as il and 
dl. 


If the terminal has a settable destructive scrolling region (like the VT100) the 
command to set this can be described with the esr capability, which takes two 
parameters: the top and bottom lines of the scrolling region. The cursor posi- 
tion is undefined after using this command. It is possible to get the effect of 
insert line or delete line using this command; the sc and rc (save and restore 
cursor) commands are also useful. Inserting lines at the top or bottom of the 
screen can also be done using ri or ind on many terminals without a true 
insert or delete line, and is often faster even on terminals with those features. 


To determine whether a terminal has destructive scrolling regions or non- 
destructive scrolling regions, create a scrolling region in the middle of the 
screen, place data on the bottom line of the scrolling region, move the cursor 
to the top line of the scrolling region, and do a reverse index (ri) followed by a 
delete line (dll) or index (ind). If the data that was originally on the bottom 
line of the scrolling region was restored into the scrolling region by the dll or 
ind, then the terminal has non-destructive scrolling regions. Otherwise, it 
has destructive scrolling regions. Do not specify esr if the terminal has non- 
destructive scrolling regions, unless ind, ri, indn, rin, dl, and dll all simu- 
late destructive scrolling. 

If the terminal has the ability to define a window as part of memory, which all 
commands affect, indicate this with the parameterized string wind. The four 
parameters are the starting and ending lines in memory and the starting and 
ending columns in memory, in that order. 
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If the terminal can retain display memory above, then the da capability 
should be given; if display memory can be retained below, then db should be 
given. These indicate that deleting a line or scrolling a full screen may bring 
non-blank lines up from below or that scrolling back with ri may bring down 
non-blank lines. 


Section 1-6 Insert/Delete Character 


There are two kinds of intelligent terminals with respect to insert and delete 
character operations which can be described using terminfo. The most com- 
mon insert and delete character operations affect only the characters on the 
current line and shift characters off the end of the line. Other terminals, such 
as the Concept 100 and the Perkin Elmer Owl, make a distinction between 
typed and untyped blanks on the screen, shifting upon an insert or delete only 
to an untyped blank on the screen which is either eliminated, or expanded to 
two untyped blanks. You can determine the kind of terminal you have by 
clearing the screen and then typing text separated by cursor motions. Type 
“abe def’ using local cursor motions (not spaces) between the abe and the 
def. Then position the cursor before the abc and put the terminal in insert 
mode. If typing characters causes the rest of the line to shift and characters to 
fall off the end, your terminal does not distinguish between blanks and 
untyped positions. If the abe shifts over to the def which then move together 
around the end of the current line and onto the next as you insert, you have 
the second type of terminal, and should give the capability in, which stands 
for “insert null.” While these are two logically separate attributes (one line 
versus multiline insert mode, and special treatment of untyped spaces) we 
have seen no terminals whose insert mode cannot be described with the single 
attribute. 


terminfo can describe both terminals that have an insert mode and terminals 
which send a simple sequence to open a blank position on the current line. 
Give as smir the sequence to get into insert mode. Give as rmir the sequence 
to leave insert mode. Now give as ich] any sequence needed to be sent just 
before sending the character to be inserted. Most terminals with a true insert 
mode will not give ich1; terminals that send a sequence to open a screen posi- 
tion should give it here. (If your terminal has both, insert mode is usually 
preferable to ich1. Do not give both unless the terminal actually requires 
both to be used in combination.) If post-insert padding is needed, give this as 
a number of milliseconds padding in ip (a string option). Any other sequence 
which may need to be sent after an insert of a single character may also be 
given in ip. If your terminal needs both to be placed into an ‘insert mode’ and 
a special code to precede each inserted character, then both smir/rmir and 
ich1 can be given, and both are used. The ich capability, with one parameter, 
n, inserts n blanks. 

If padding is necessary between characters typed while not in insert mode, 
give this as a number of milliseconds padding in rmp. 

It is occasionally necessary to move around while in insert mode to delete 
characters on the same line (e.g., if there is a tab after the insertion position). 
If your terminal allows motion while in insert mode you can give the capabil- 
ity mir to speed up inserting in this case. Omitting mir affects only speed. 
Some terminals (notably Datamedia’s) must not have mir because of the way 
their insert mode works. 
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Finally, you can specify dch1 to delete a single character, dch with one 
parameter, n, to delete n characters, and delete mode by giving smdc and 


rmdc to enter and exit delete mode (any mode the terminal needs to be placed 
in for dch1 to work). 


A command to erase n characters (equivalent to outputting n blanks without 
moving the cursor) can be given as ech with one parameter. 


Section 1-7 Highlighting, Underlining, and Visible Bells 
Your device may have one or more kinds of display attributes that allow you to 
highlight selected characters when they appear on the screen. The following 
display modes (shown with the names by which they are set) may be available: 
a blinking screen (blink), bold or extra-bright characters (bold), dim or half- 
bright characters (dim), blanking or invisible text (invis), protected text 
(prot), a reverse-video screen (rev), and an alternate character set (smacs to 
enter this mode and rmacs to exit it). (If a command is necessary before you 
can enter alternate character set mode, give the sequence in enacs (enable 
alternate-character-set mode). Turning on any of these modes singly may or 
may not turn off other modes. 


sgr0 should be used to turn off all video enhancement capabilities. It should 
always be specified because it represents the only way to turn off some capa- 
bilities, such as dim or blink. 


You should choose one display method as standout mode (see curses(3X)) and 
use it to highlight error messages and other kinds of text to which you want to 
draw attention. Choose a form of display that provides strong contrast but 
that is easy on the eyes. (We recommend reverse-video plus half-bright or 
reverse-video alone.) The sequences to enter and exit standout mode are given 
as smso and rmso, respectively. If the code to change into or out of standout 
mode leaves one or even two blank spaces on the screen, as the TVI 912 and 
Teleray 1061 do, then xmc should be given to tell how many spaces are left. 


Sequences to begin underlining and end underlining can be specified as smul 
and rmul , respectively. If the device has a sequence to underline the current 
character and to move the cursor one space to the right (such as the Micro- 
Term MIME), this sequence can be specified as uc. 


Terminals with the “magic cookie” glitch (xmc) deposit special “cookies” when 
they receive mode-setting sequences, which affect the display algorithm 
rather than having extra bits for each character. Some terminals, such as the 
Hewlett-Packard 2621, automatically leave standout mode when they move to 
a new line or the cursor is addressed. Programs using standout mode should 
exit standout mode before moving the cursor or sending a newline, unless the 
megr capability, asserting that it is safe to move in standout mode, is present. 


If the terminal has a way of flashing the screen to indicate an error quietly (a 
bell replacement), indicate this as flash; it must not move the cursor. A good 
flash can be done by changing the screen into reverse video, pad for 200 ms, 
then return the screen to normal video. 


If the cursor needs to be made more visible than normal when it is not on the 
bottom line (to make, for example, a non-blinking underline into an easier to 
find block or blinking underline) give this sequence as cvvis. The boolean 
chts should also be given. If there is a way to make the cursor completely 
invisible, give that as civis. The capability cnorm should be given which 
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undoes the effects of either of these modes. 


If your terminal generates underlined characters by using the underline char- 
acter (with no special sequences needed) even though it does not otherwise 
overstrike characters, then you should specify the capability ul. For devices 
on which a character overstriking another leaves both characters on the 
screen, specify the capability os. If overstrikes are erasable with a blank, 
then this should be indicated by specifying eo. 


If there is a sequence to set arbitrary combinations of modes, this should be 
given as sgr (set attributes), taking nine parameters. Each parameter is 
either 0 or non-zero, as the corresponding attribute is on or off. The nine 
parameters are, in order: standout, underline, reverse, blink, dim, bold, blank, 
protect, alternate character set. Not all modes need to be supported by sgr; 
only those for which corresponding separate attribute commands exist should 
be supported. For example, let’s assume that the terminal in question needs 
the following escape sequences to turn on various modes. 


tparm 
Parameter Attribute Escape Sequence 
none \E[Om 
pl standout \E[0;4;7m 
p2 underline \E[0;3m 
p3 reverse \E[0;4m 
p4 blink \E(0;5m 
p5 dim \E[0;7m 
pé bold \E[0;3;4m 
p7 invis \E[0;8m 
ps protect not available 
p9 altcharset “O (off) “N(on) 


Each escape sequence requires a 0 to turn off other modes before turning on 
its own mode. Also, as suggested above, standout is set up to be the combina- 
tion of reverse and dim. Also, because this terminal has no bold mode, bold is 
set up as the combination of reverse and underline. In addition, to allow com- 
binations, such as underline+blink, the sequence to use would be \E[0;3;5m. 
The terminal doesn’t have protect mode, either, but that cannot be simulated 
in any way, so p8is ignored. The altcharset mode is different in that it is 
either “O or “N, depending on whether it is off or on. If all modes were to be 
turned on, the sequence would be \E[0;3;4;5;7;8m°N. 
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Now look at different output sequences, for example ;3 is output when either 
p2 or p6 is true, that is, if either underline or bold modes are turned on. Writ- 
ing out the above sequences, along with their dependencies, gives the follow- 


ing: 
Sequence When to Output Terminfo Translation 
\E[O always \E[O 
33 if p2 or p6 M2? Wp2%p6% | %ot;3%; 
34 if pl or p3 or p6 %2%p1%p3% | Mpb% | Mt;4%; 
35 if p4 %2 Wp4%t;5%; 
a7 if pl or p5 %2 Mp1 %p5% | %t;7%; 
38 if p7 %2? pT %t;8%; 
m always m 
‘N or “O if p9 *N, else “O D2 WpIVt N%e"O%; 


Putting this all together into the sgr sequence gives: 


sgr=\E[0%?%p2%p6% | %t;3%; %? Mp1 %p3% | Yopb% | %ot;4%;%? Mp5 Zt; 
5%; %?%p1 %p5% | Yt; 7%; %? Yop 7 %t;8%;m %? Yop9 Zt" N %e"O%;, 


Remember that sgr and sgr0 must always be specified. 


Section 1-8 Keypad 
If the device has a keypad that transmits sequences when the keys are 
pressed, this information can also be specified. Note that it is not possible to 
handle devices where the keypad only works in local mode. (This applies, for 
example, to the unshifted Hewlett-Packard 2621 keys.) If the keypad can be 
set to transmit or not transmit, specify these sequences as smkx and rmkx. 
Otherwise the keypad is assumed to always transmit. 


The sequences sent by the left arrow, right arrow, up arrow, down arrow, and 
home keys can be given as kcubl1, kcufl, keuul, kcud1, and khome, respec- 
tively. If there are function keys such as f0, fl, ..., £63, the sequences they send 
can be specified as kf0, kf1,..., kf63. If the first 11 keys have labels other 
than the default f0 through f10, the labels can be given as 10, If, ..., 1f10. The 
codes transmitted by certain other special keys can be given: kll (home down), 
kbs (backspace), ktbe (clear all tabs), ketab (clear the tab stop in this col- 
umn), kelr (clear screen or erase key), kdch1 (delete character), kdl1 (delete 
line), krmir (exit insert mode), kel (clear to end of line), ked (clear to end of 
screen), kich] (insert character or enter insert mode), kill (insert line), knp 
(next page), kpp (previous page), kind (scroll forward/down), kri (scroll back- 
ward/up), khts (set a tab stop in this column). In addition, if the keypad has a 
3 by 3 array of keys including the four arrow keys, the other five keys can be 
given as kal, ka3, kb2, kel, and ke3. These keys are useful when the effects 
of a 3 by 3 directional pad are needed. Further keys are defined above in the 
capabilities. list. 
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Strings to program function keys can be specified as pfkey, pfloc, and pfx. A 
string to program screen labels should be specified as pln. Each of these 
strings takes two parameters: a function key identifier and a string to pro- 
gram it with. pfkey causes pressing the given key to be the same as the user 
typing the given string; pfloc causes the string to be executed by the terminal 
in local mode; and pfx causes the string to be transmitted to the computer. 
The capabilities nlab, lw and lh define the number of programmable screen 
labels and their width and height. If there are commands to turn the labels on 
and off, give them in smln and rmIn. smln is normally output after one or 
more pln sequences to make sure that the change becomes visible. 


Section 1-9 Tabs and Initialization 


If the device has hardware tabs, the command to advance to the next tab stop 
can be given as ht (usually control I). A backtab command that moves left- 
ward to the next tab stop can be given as cbt. By convention, if tty modes 
show that tabs are being expanded by the computer rather than being sent to 
the device, programs should not use ht or cbt (even if they are present) 
because the user may not have the tab stops properly set. If the device has 
hardware tabs that are initially set every n spaces when the device is powered 
up, the numeric parameter it is given, showing the number of spaces the tabs 
are set to. This is normally used by tput init (see tput(1)) to determine 
whether to set the mode for hardware tab expansion and whether to set the 
tab stops. If the device has tab stops that can be saved in nonvolatile memory, 
the terminfo description can assume that they are properly set. If there are 
commands to set and clear tab stops, they can be given as tbe (clear all tab 
stops) and hts (set a tab stop in the current column of every row). 


Other capabilities include: isl, is2, and is3, initialization strings for the 
device; iprog, the path name of a program to be run to initialize the device; 
and if, the name of a file containing long initialization strings. These strings 
are expected to set the device into modes consistent with the rest of the ter- 
minfo description. They must be sent to the device each time the user logs in 
and be output in the following order: run the program iprog; output is]; out- 
put is2; set the margins using mgce, smg]l and smgr; set the tabs using tbe 
and hts; print the file if; and finally output is3. This is usually done using the 
init option of tput(1); see profile(4). 


Most initialization is done with is2. Special device modes can be set up with- 
out duplicating strings by putting the common sequences in is2 and special 
cases in isl and is3. Sequences that do a harder reset from a totally unknown 
state can be given as rsl, rs2, rf, and rs3, analogous to is1, is2, is3, and if. 
(The method using files, if and rf, is used for a few terminals, from 
/usr/lib/tabset / *; however, the recommended method is to use the initializa- 
tion and reset strings.) These strings are output by tput reset, which is used 
when the terminal gets into a wedged state. Commands are normally placed 
in rs1, rs2, rs3, and rf only if they produce annoying effects on the screen and 
are not necessary when logging in. For example, the command to set a termi- 
nal into 80-column mode would normally be part of is2, but on some terminals 
it causes an annoying glitch on the screen and is not normally needed because 
the terminal is usually already in 80-column mode. 
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If a more complex sequence is needed to set the tabs than can be described by 
using tbe and hts, the sequence can be placed in is2 or if. 


Any margin can be cleared with mgce. (For instructions on how to specify com- 
mands to set and clear margins, refer to PRINTER CAPABILITIES.) 


Section 1-10 Delays 
Certain capabilities control padding in the tty(7) driver. These are primarily 
needed by hard-copy terminals, and are used by tput init to set tty modes 
appropriately. Delays embedded in the capabilities cr, ind, cubl, ff, and tab 
can be used to set the appropriate delay bits to be set in the tty driver. If pb 
(padding baud rate) is given, these values can be ignored at baud rates below 
the value of pb. 


Section 1-11 Status Lines 
If the terminal has an extra status line that is not normally used by software, 
this fact can be indicated. If the status line is viewed as an extra line below 
the bottom line, into which one can cursor address normally (such as the 
Heathkit h19’s 25th line, or the 24th line of a VT100 which is set to a 23-line 
scrolling region), the capability hs should be given. Special strings that go to 
a given column of the status line and return from the status line can be given 
as ts] and fsl. (fsl must leave the cursor position in the same place it was 
before tsl. If necessary, the sc and re strings can be included in ts] and fsl to 
get this effect.) The capability tsl takes one parameter, which is the column 
number of the status line the cursor is to be moved to. 


If escape sequences and other special commands, such as tab, work while in 
the status line, the flag eslok can be given. A string which turns off the sta- 
tus line (or otherwise erases its contents) should be given as dsl. If the termi- 
nal has commands to save and restore the position of the cursor, give them as 
sc andre. The status line is normally assumed to be the same width as the 
rest of the screen, e.g., cols. If the status line is a different width (possibly 
because the terminal does not allow an entire line to be loaded) the width, in 
columns, can be indicated with the numeric parameter wsl. 


Section 1-12 Line Graphics 
If the device has a line drawing alternate character set, the mapping of glyph 
to character would be given in acsc. The definition of this string is based on 
the alternate character set used in the DEC VT100 terminal, extended 
slightly with some characters from the AT&T 4410v1 terminal. 
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Glyph Name 


arrow pointing right 
arrow pointing left 
arrow pointing down 
solid square block 
lantern symbol 
arrow pointing up 
diamond 

checker board (stipple) 
degree symbol 
plus/minus 

board of squares 
lower right corner 
upper right corner 
upper left corner 
lower left corner 
plus 

scan line 1 
horizontal line 

scan line 9 

left tee (+) 

right tee (-I ) 
bottom tee (1) 

top tee (| ) 

vertical line 

bullet 


vt100+ 
Character 


“| HoO- 


ixeccrtunos FJ -wusm 4H 
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The best way to describe a new device’s line graphics set is to add a third col- 
umn to the above table with the characters for the new device that produce 
the appropriate glyph when the device is in the alternate character set mode. 


For example, 


vt100+ Newtty 
Char Char 


Glyph Name 


upper left corner 
lower left corner 
upper right corner 
lower right corner 
horizontal line 
vertical line 


xourRs 


Onda 


Now write down the characters left to right, as in “acsc=]RmFkTjGq\,x.”. 


In addition, terminfo allows you to define multiple character sets. See Section 


2-5 for details. 


Section 1-13 Color Manipulation 
Let us define two methods of color manipulation: the Tektronix method and 
the HP method. The Tektronix method uses a set of N predefined colors 
(usually 8) from which a user can select current foreground and background 
colors. Thus, a terminal can support up to N colors mixed into N*N 
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color-pairs to be displayed on the screen at the same time. Using the HP 
method, the user cannot define the foreground independently of the back- 
ground, or vice-versa. Instead, the user must define an entire color-pair at 
once. Up to M color-pairs, made from 2*M different colors, can be defined this 
way. Most existing color terminals belong to one of these two classes of termi- 
nals. 


The numeric variables colors and pairs define the number of colors and 
color-pairs that can be displayed on the screen at the same time. If a terminal 
can change the definition of a color (for example, the Tektronix 4100 and 4200 
series terminals), this should be specified with ccc (can change color). To 
change the definition of a color (Tektronix method), use initc (initialize color). 
It requires four arguments: color number (ranging from 0 to colors—1) and 
three RGB (red, green, and blue) values (ranging from 0 to 1000). 


Tektronix 4100 series terminals use a type of color notation called HLS (Hue 
Lightness Saturation) instead of RGB color notation. For such terminals one 
must define a boolean variable hls. The last three arguments to the inite 
string would then be HLS values: H, ranging from 0 to 360; and Land S, 
ranging from 0 to 100. 


If a terminal can change the definitions of colors, but uses a color notation dif- 
ferent from RGB and HLS, a mapping to either RGB or HLS must be devel- 
oped. 


To set current foreground or background to a given color, use setf (set fore- 
ground) and setb (set background). They require one parameter: the number 
of the color. To initialize a color-pair (HP method), use initp (initialize pair). 
It requires seven parameters: the number of a color-pair (range=0 to 
pairs-1), and six RGB values: three for the foreground followed by three for 
the background. (Each of these groups of three should be in the order RGB.) 
When initc or initp are used, RGB or HLS arguments should be in the order 
"red, green, blue” or "hue, lightness, saturation"), respectively. To make a 
color-pair current, use scp (set color-pair). sep takes one parameter—the 
number of a color-pair. 


Some terminals (for example, most color terminal emulators for PCs) erase 
areas of the screen with current background color. In such cases, bce (back- 
ground color erase) should be defined. The variable op (original pair) contains 
a sequence for setting the foreground and the background colors to what they 
were at the terminal start-up time. Similarly, oc (original colors) contains a 
control sequence for setting all colors (for the Tektronix method) or color-pairs 
(for the HP method) to the values they had at the terminal start-up time. 


Some color terminals substitute color for video attributes. Such video attri- 
butes should not be combined with colors. Information about these video 
attributes should be packed into the nev (no color video) variable. There isa 
one-to-one correspondence between the nine least significant bits of that vari- 
able and the video attributes. The following table depicts this correspondence. 
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Bit Decimal 


@ Attribute Position Value 
A_STANDOUT 0 1 
A_UNDERLINE 1 2 
A_REVERSE 2 4 
A_BLINK 3 8 
A_DIM 4 16 
A_BOLD 5 32 
A_INVIS 6 64 
A_PROTECT “th 128 
A_ALTCHARSET 8 256 


When a particular video attribute should not be used with colors, the corre- 
sponding nev bit should be set to 1; otherwise it should be set to 0. To deter- 

. mine the information to pack into the nev variable, you must add together the 
decimal values corresponding to those attributes that cannot coexist with 
colors. For example, if the terminal uses colors to simulate reverse video (bit 
number 2 and decimal value 4) and bold (bit number 5 and decimal value 32), 
the resulting value for nev will be 36 (4 + 32). 


Section 1-14 Miscellaneous 
If the terminal requires other than a null (zero) character as a pad, indicate 
this with pad. Only the first character of the pad string is used. If the termi- 
nal does not have a pad character, specify npc. 


& If the terminal can move up or down half a line, this can be indicated with hu 
(half-line up) and hd (half-line down). This is primarily useful for superscripts 
and subscripts on hardcopy terminals. If a hardcopy terminal can eject to the 

next page (form feed), give this as ff (usually Crtl-L). 


If there is a command to repeat a given character a given number of times (to 
save time transmitting a large number of identical characters) this can be 
indicated with the parameterized string rep. The first parameter is the char- 
acter to be repeated and the second is the number of times to repeat it. Thus, 
tparm(repeat_char, ’x’, 10) is the same as xxxxxxxxxx. 


If the terminal has a settable command character, such as the Tektronix 4025, 
this can be indicated with emdch. A prototype command character is chosen 
which is used in all capabilities. This character is given in the emdch capa- 
bility to identify it. The following convention is supported on some operating 
systems: If the environment variable CC exists, all occurrences of the proto- 
type character are replaced with the character in CC. 


Terminal descriptions that do not represent a specific kind of known terminal, 
such as switch, dialup, patch, and network, should include the gn (generic) 
capability so that programs can complain that they do not know how to talk to 
the terminal. (This capability does not apply to virtual terminal descriptions 
for which the escape sequences are known.) If the terminal is one of those 
supported by the operating system virtual terminal protocol, the terminal 
number can be given as vt. A line-turn-around sequence to be transmitted 
@ before doing reads should be specified in rfi. 


If the device uses xon/xoff handshaking for flow control, give xon. Padding 
information should still be included so that routines can make better decisions 
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about costs, but actual pad characters will not be transmitted. Sequences to 
turn on and off xon/xoff handshaking may be given in smxon and rmxon. If 
the characters used for handshaking are not “S and *Q, they may be specified 
with xonc and xoffc. 


If the terminal has a “meta key” which acts as a shift key, setting the 8th bit 
of any character transmitted, indicate this with km. Otherwise, software 
assumes that the 8th bit is parity and it is usually cleared. If strings exist to 
turn this “meta mode” on and off, they can be given as smm and rmm. 


If the terminal has more lines of memory than will fit on the screen at once, 
the number of lines of memory can be indicated with lm. A value of lm#0 indi- 
cates that the number of lines is not fixed, but that there is more memory 
than fits on the screen. . 


Media copy strings which control an auxiliary printer connected to the termi- 
nal can be given as mc0: print the contents of the screen, me4: turn off the 
printer, and mc5: turn on the printer. When the printer is on, all text sent to 
the terminal is sent to the printer. A variation, me5p, takes one parameter, 
and leaves the printer on for as many characters as the value of the parame- 
ter, then turns the printer off. The parameter should not exceed 255. If the 
text is not displayed on the terminal screen when the printer is on, specify 
mc5i (silent printer). All text, including mc4, is transparently passed to the 
printer while an mc5p is in effect. 


Section 1-15 Special Cases 
The working model used by terminfo fits most terminals reasonably well. 
However, some terminals do not completely match that model, requiring spe- 
cial support by terminfo. They may be unusual devices or, for some reason, do 
not have all the features of the terminfo model implemented. 


Terminals that cannot display tilde (~) characters, such as certain Hazeltine 
terminals, should indicate hz. 


Terminals that ignore a linefeed immediately after an am wrap, such as the 
Concept 100, should indicate xen]. Those terminals whose cursor remains on 
the right-most column until another character has been received, rather than 
wrapping immediately upon receiving the right-most character, such as the 
VT100, should also indicate xenl. 


If el is required to get rid of standout (instead of writing normal text on top of 
it), xhp should be given. 


Teleray terminals whose tabs turn all characters moved over to blanks should 
indicate xt (destructive tabs). This capability is also taken to mean that it is 
not possible to position the cursor on top of a “magic cookie.” Therefore, to 
erase standout mode, it is necessary, instead, to use delete and insert line. 


Those Beehive Superbee terminals which do not transmit the escape or con- 
trol—C characters, should specify xsb, indicating that the f1 key is to be used 
for escape and the f2 key for control—C. 


Section 1-16 Similar Terminals 
If there are two very similar terminals, one can be defined as being just like 
the other with certain exceptions. The string capability use can be given with 
the name of the similar terminal. The capabilities given before use override 
those in the terminal type invoked by use. A capability can be canceled by 
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placing xx@ to the left of the capability definition, where xx is the capability. 

For example, the entry : 
att4424-2]Teletype 4424 in display function group ii, 
rev@, sgr@, smul@; use=att4424, 


defines an AT&T 4424 terminal that does not have the rev, sgr, and smul 
capabilities, and hence cannot do highlighting. This is useful for different 
modes for a terminal, or for different user preferences. More than one use 
capability may be given. 


PART 2 PRINTER CAPABILITIES 


The terminfo database allows you to define capabilities of printers as well as 
terminals. To find out what capabilities are available for printers as well as 
for terminals, see the two lists under "DEVICE CAPABILITIES" that list 
capabilities by variable and by capability name. 


Section 2-1 Rounding Values 


Because parameterized string capabilities work only with integer values, we 
recommend that terminfo designers create strings that expect numeric values 
that have been rounded. Application designers should note this and should 
always round values to the nearest integer before using them with a 
parameterized string capability. 


Section 2-2 Printer Resolution 
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A printer’s resolution is defined to be the smallest spacing of characters it can 
achieve. In general printers have independent resolution horizontally and 
vertically. Thus the vertical resolution of a printer can be determined by 
measuring the smallest achievable distance between consecutive printing 
baselines, while the horizontal resolution can be determined by measuring the 
smallest achievable distance between the left-most edges of consecutive 
printed, identical, characters. 


All printers are assumed to be capable of printing with a uniform horizontal 
and vertical resolution. The view of printing that terminfo currently presents 
is one of printing inside a uniform matrix: all characters are printed at fixed 
positions relative to each “cell” in the matrix; furthermore, each cell has the 
same size given by the smallest horizontal and vertical step sizes dictated by 
the resolution. (The cell size can be changed as will be seen later.) 


Many printers are capable of proportional printing, where the horizontal spac- 
ing depends on the size of the character last printed. terminfo does not make 
use of this capability, although it does provide enough capability definitions to 
allow an application to simulate proportional printing. 


A printer must not only be able to print characters as close together as the 
horizontal and vertical resolutions suggest, but also of moving to a position an 
integral multiple of the smallest distance away from a previous position. Thus 
printed characters can be spaced apart a distance that is an integral multiple 
of the smallest distance, up to the length or width of a single page. 


Some printers can have different resolutions depending on different modes. In 
normal mode, the existing terminfo capabilities are assumed to work on col- 
umns and lines, just like a video terminal. Thus the old lines capability 
would give the length of a page in lines, and the cols capability would give the 
width of a page in columns. In micro mode, many terminfo capabilities work 
on increments of lines and columns. With some printers the micro mode may 
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be concomitant with normal mode, so that all the capabilities work at the 
same time. ‘ : & 
Section 2-3 Specifying Printer Resolution 


The printing resolution of a printer is given in several ways. Each specifies 
the resolution as the number of smallest steps per distance: 


He Specification of Printer Resolution 
Characteristic Number of Smallest Steps 
orhi Steps per inch horizontally 
orvi Steps per inch vertically 
ore Steps per column 
orl Steps per line 


When printing in normal mode, each character printed causes movement to 
the next column, except in special cases described later; the distance moved is 
the same as the per-column resolution. Some printers cause an automatic 
movement to the next line when a character is printed in the rightmost posi- 
tion; the distance moved vertically is the same as the per-line resolution. 
When printing in micro mode, these distances can be different, and may be 
zero for some printers. 


Specification of Printer Resolution 
Automatic Motion after Printing 


Normal Mode: 

ore Steps moved horizontally 
orl Steps moved vertically 
Micro Mode: 

mcs Steps moved horizontally 
mls Steps moved vertically 


Some printers are capable of printing wide characters. The distance moved 
when a wide character is printed in normal mode may be different from when 
a regular width character is printed. The distance moved when a wide charac- 
ter is printed in micro mode may also be different from when a regular charac- 
ter is printed in micro mode, but the differences are assumed to be related: if 
the distance moved for a regular character is the same whether in normal 
mode or micro mode (mes=ore), then the distance moved for a wide character 
is also the same whether in normal mode or micro mode. This doesn’t mean 
the normal character distance is necessarily the same as the wide character 
distance, just that the distances don’t change with a change in normal to 
micro mode. However, if the distance moved for a regular character is differ- 
ent in micro mode from the distance moved in normal mode (mes<ore), the 
micro mode distance is assumed to be the same for a wide character printed in 
micro mode, as the table below shows. 
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placing xx@ to the left of the capability definition, where xx is the capability. 
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defines an AT&T 4424 terminal that does not have the rev, sgr, and smul 
capabilities, and hence cannot do highlighting. This is useful for different 
modes for a terminal, or for different user preferences. More than one use 
capability may be given. 
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The terminfo database allows you to define capabilities of printers as well as 
terminals. To find out what capabilities are available for printers as well as 
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recommend that terminfo designers create strings that expect numeric values 
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Section 2-2 Printer Resolution 


4/90 


A printer’s resolution is defined to be the smallest spacing of characters it can 
achieve. In general printers have independent resolution horizontally and 
vertically. Thus the vertical resolution of a printer can be determined by 
measuring the smallest achievable distance between consecutive printing 
baselines, while the horizontal resolution can be determined by measuring the 
smallest achievable distance between the left-most edges of consecutive 
printed, identical, characters. 


All printers are assumed to be capable of printing with a uniform horizontal 
and vertical resolution. The view of printing that terminfo currently presents 
is one of printing inside a uniform matrix: all characters are printed at fixed 
positions relative to each “cell” in the matrix; furthermore, each cell has the 
same size given by the smallest horizontal and vertical step sizes dictated by 
the resolution. (The cell size can be changed as will be seen later.) 


Many printers are capable of proportional printing, where the horizontal spac- 
ing depends on the size of the character last printed. terminfo does not make 
use of this capability, although it does provide enough capability definitions to 
allow an application to simulate proportional printing. 


A printer must not only be able to print characters as close together as the 
horizontal and vertical resolutions suggest, but also of moving to a position an 
integral multiple of the smallest distance away from a previous position. Thus 
printed characters can be spaced apart a distance that is an integral multiple 
of the smallest distance, up to the length or width of a single page. 


Some printers can have different resolutions depending on different modes. In 
normal mode, the existing terminfo capabilities are assumed to work on col- 
umns and lines, just like a video terminal. Thus the old lines capability 
would give the length of a page in lines, and the cols capability would give the 
width of a page in columns. In micro mode, many terminfo capabilities work 
on increments of lines and columns. With some printers the micro mode may 
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be concomitant with normal mode, so that all the capabilities work at the 
same time. : 

Section 2-3 Specifying Printer Resolution 
The printing resolution of a printer is given in several ways. Each specifies 
the resolution as the number of smallest steps per distance: 


= Specification of Printer Resolution 
Characteristic Number of Smallest Steps 
orhi Steps per inch horizontally 
orvi Steps per inch vertically 
ore Steps per column 
orl Steps per line 


When printing in normal mode, each character printed causes movement to 
the next column, except in special cases described later; the distance moved is 
the same as the per-column resolution. Some printers cause an automatic 
movement to the next line when a character is printed in the rightmost posi- 
tion; the distance moved vertically is the same as the per-line resolution. 
When printing in micro mode, these distances can be different, and may be 
zero for some printers. 


Specification of Printer Resolution 
Automatic Motion after Printing 


Normal Mode: 

ore Steps moved horizontally 
orl Steps moved vertically 
Micro Mode: 

mcs Steps moved horizontally 
mls Steps moved vertically 


Some printers are capable of printing wide characters. The distance moved 
when a wide character is printed in normal mode may be different from when 
a regular width character is printed. The distance moved when a wide charac- 
ter is printed in micro mode may also be different from when a regular charac- 
ter is printed in micro mode, but the differences are assumed to be related: if 
the distance moved for a regular character is the same whether in normal 
mode or micro mode (mes=ore), then the distance moved for a wide character 
is also the same whether in normal mode or micro mode. This doesn’t mean 
the normal character distance is necessarily the same as the wide character 
distance, just that the distances don’t change with a change in normal to 
micro mode. However, if the distance moved for a regular character is differ- 
ent in micro mode from the distance moved in normal mode (mes<ore), the 
micro mode distance is assumed to be the same for a wide character printed in 
micro mode, as the table below shows. 
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Specification of Printer Resolution 
Automatic Motion after Printing Wide Character 


Normal Mode or Micro Mode (mcs = orc): 
widcs Steps moved horizontally 


Micro Mode (mcs < orc): 
mcs Steps nioved horizontally 


There may be control sequences to change the number of columns per inch 
(the character pitch) and to change the number of lines per inch (the line 
pitch). If these are used, the resolution of the printer changes, but the type of 
change depends on the printer, as follows: 


Specification of Printer Resolution 
Changing the Character/Line Pitches 


cpi Change character pitch 
cpix Ifset, epi changes orhi, otherwise changes orc 


Ipi Change line pitch 
Ipix If set, Ipi changes orvi, otherwise changes orl 


chr Change steps per column 
evr Change steps per line 


The cpi and Ipi string capabilities are each used with a single argument, the 
pitch in columns (or characters) and lines per inch, respectively. The chr and 
evr string capabilities are each used with a single argument, the number of 
steps per column and line, respectively. 


Using any of the control sequences in these strings implies a change in some 
of the values of ore, orhi, orl, and orvi. Also, the distance moved when a 
wide character is printed, widcs, changes in relation to ore. The distance 
moved when a character is printed in micro mode, mes, changes similarly, 
with one exception: if the distance is 0 or 1, then no change is assumed (see 
items marked with t¢ in the following table). 


Programs that use epi, Ipi, chr, or evr should recalculate the printer resolu- 
tion (and should recalculate other values —refer to Effect of Changing Print- 
ing Resolution). 
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Specification of Printer Resolution 
Effects of Changing the Character/Line Pitches 


Before After 
Using cpi with cpix clear: 
orhi’ orhi . 


Using cpi with cpix set: 


orhi’ orhi=ore-V,p; 

ore’ ore 

Using lpi with Ipix-clear: 

orvi’ - orvi 2 

ou? ore ti 
Vipi 

Using lpi with Ipix set: 

orvi’ orvi-orl-V jp; 

orl’ orl 

Using chr: 

orhi’ orhi 

ore’ Vehr 

Using evr: 

orvi’ orvi 

orl’ Veur 


Using epi or chr: 


ides’ A 5 orc 
wides widcs=widcs’ ia 
mes ’t , orc . 
mes=mcs’—— 
orc 


Vepir Vipis Venr» and Ver are the arguments used with epi, Ipi, chr, and evr, 
respectively. The t mark indicates the old value. 


Section 2-4 Capabilities that Cause Movement 
In the following descriptions, movement refers to the motion of the “current 
position.” With video terminals this would be the cursor; with some printers 
this is the carriage position. Other printers have different equivalents. In 
general, the current position is where a character would be displayed if 
printed. 
terminfo has string capabilities for control sequences that cause movement a 


number of full columns or lines. It also has equivalent string capabilities for 
control sequences that cause movement a number of smallest steps. 
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String Capabilities for Motion 


mcubl Move 1 step left 
meufl Move 1 step right 
mcuul Move 1 step up 
mcud1 Move 1 step down 


mceub Move Ntteps left 
meuf Move N steps right 
mcuu Move N steps up 
mcud Move N steps down 


mhpa_ Move N steps from the left 
mvpa Move N steps from the top 


The latter six strings are each used with a single argument, N. 


Sometimes the motion is limited to less than the width or length of a page. 
Also, some printers don’t accept absolute motion to the left of the current posi- 
tion. terminfo has capabilities for specifying these limits. 
Limits to Motion 
mjump Limit on use of mcub1, mcuf1, mcuul, mcud1 
maddr _ Limit on use of mhpa, mvpa 


xhpa If set, hpa and mhpa can’t move left 
xvpa If set, vpa and mvpa can’t move up 


If a printer needs to be in a micro mode for the motion capabilities described 
above to work, there are string capabilities defined to contain the control 
sequence to enter and exit this mode. A boolean is available for those printers 
where using a carriage return causes an automatic return to normal mode. 


Entering/Exiting Micro Mode 


smicm Enter micro mode 
rmicm Exit micro mode 


erxm _ Using cr exits micro mode 


The movement made when a character is printed in the rightmost position 
varies among printers. Some make no movement, some move to the beginning 
of the next line, others move to the beginning of the same line. terminfo has 
boolean capabilities for describing all three cases. 


What Happens After Character 
Printed in Rightmost Position 


sam Automatic move to beginning of same line 
Some printers can be put in a mode where the normal direction of motion is 
reversed. This mode can be especially useful when there are no capabilities 
for leftward or upward motion, because those capabilities can be built from 
the motion reversal capability and the rightward or downward motion capabil- 
ities. It is best to leave it up to an application to build the leftward or upward 
capabilities, though, and not enter them in the terminfo database. This allows 
several reverse motions to be strung together without intervening wasted 
steps that leave and reenter reverse mode. 
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Entering/Exiting Reverse Modes 


sim Reverse sense of horizontal motions 
rlm Restore sense of horizontal motions 
sum Reverse sense of vertical motions 
rum Restore sense of vertical motions 

ai While sense of horizontal motions reversed: 


meubl Move 1 step right 
meufl Move 1 step left 
mcub  MoveN steps right 
mcuf Move N steps left 


cubl Move 1 column right 
cuf1 Move 1 column left 
cub Move N columns right 
cuf Move N columns left 


While sense of vertical motions reversed: 
mcuul Move 1 step down 

mcudi Move 1 step up 

mcuu MoveWN steps down 

mcud MoveWN steps up 


cuul Move 1 line down 
cud1 Move 1 line up 
cuu Move N lines down 
cud Move N lines up 


The reverse motion modes should not affect the mvpa and mhpa absolute 
motion capabilities. The reverse vertical motion mode should, however, also 
reverse the action of the line wrapping that occurs when a character is printed 
in the right-most position. Thus printers that have the standard terminfo 
capability am defined should experience motion to the beginning of the previ- 
ous line when a character is printed in the right-most position under reverse 
vertical motion mode. 


The action when any other motion capabilities are used in reverse motion 
modes is not defined; thus, programs must exit reverse motion modes before 
using other motion capabilities. 


Two miscellaneous capabilities complete the list of new motion capabilities. 
One of these is needed for printers that move the current position to the begin- 
ning of a line when certain control characters, such as “line-feed” or “form- 
feed,” are used. The other is used for the capability of suspending the motion 
that normally occurs after printing a character. 


Miscellaneous Motion Strings 


docr List of control characters causing cr 
zerom Prevent auto motion after printing next single character 


Margins 


terminfo provides two strings for setting margins on terminals: one for the left 
and one for the right margin. Printers, however, have two additional margins, 
for the top and bottom margins of each page. Furthermore, some printers 
require not using motion strings to move the current position to a margin and 
then fixing the margin there, but require the specification of where a margin 
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should be regardless of the current position. Therefore terminfo offers six 
additional strings for defining margins with printers. 


Setting Margins 
smgl Set left margin at current column 
smgr Set right margin at current column 
smgb Set bottom margin at current line 
smgt Set top margin at current line 


smgbp Set bottom margin at line N 
smglp Set left margin at column N 
smgrp Set right margin at column N 
smgtp Set top margin at line N 


The last four strings are used with one or more arguments that give the posi- 
tion of the margin or margins to set. If both of smglp and smgrp are set, 
each is used with a single argument, N, that gives the column number of the 
left and right margin, respectively. If both of smgtp and smgbp are set, each 
is used to set the top and bottom margin, respectively: smgtp is used with a 
single argument, N, the line number of the top margin; however, smgbp is 
used with two arguments, N and M, that give the line number of the bottom 
margin, the first counting from the top of the page and the second counting 
from the bottom. This accommodates the two styles of specifying the bottom 
margin for different printers. When coding a terminfo entry for a printer that 
has a settable bottom margin, only the first or second parameter should be 
used, depending on the printer. When writing an application that uses 
smgbp to set the bottom margin, both arguments must be given. 


If only one of smglp and smgrp is set, then it is used with two arguments, the 
column number of the left and right margins, in that order. Likewise, if only 
one of smgtp and smgbp is set, then it is used with two arguments that give 
the top and bottom margins, in that order, counting from the top of the page. 
Thus when coding a terminfo entry for a printer that requires setting both left 
and right or top and bottom margins simultaneously, only one of smglp and 
smgrp or smgtp and smgbp should be defined; the other should be left blank. 
When writing an application that uses these string capabilities, the pairs 
should be first checked to see if each in the pair is set or only one is set, and 
should then be used accordingly. 


In counting lines or columns, line zero is the top line and column zero is the 
left-most column. A zero value for the second argument with smgbp means 
the bottom line of the page. 


All margins can be cleared with mge. 


Shadows, Italics, Wide Characters, Superscripts, Subscripts 


Five new sets of strings are used to describe the capabilities printers have of 
enhancing printed text. 
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Enhanced Printing 


sshm Enter shadow-printing mode 
rshm Exit shadow-printing mode 


sitm Enter italicizing mode 
ritm Exit italicizing mode 


swidm Enter wide character mode 
rwidm Exit wide character mode 


ssupm Enter superscript mode 
rsupm Exit superscript mode 
supcs List of characters available as superscripts 


ssubm Enter subscript mode 
rsubm_ _ Exit subscript mode 
subes _List of characters available as subscripts 


Ifa printer requires the sshm control sequence before every character to be 
shadow-printed, the rshm string is left blank. Thus programs that find a con- 
trol sequence in sshm but none in rshm should use the sshm control 
sequence before every character to be shadow-printed; otherwise, the sshm 
control sequence should be used once before the set of characters to be 
shadow-printed, followed by rshm. The same is also true of each of the 
sitm/ritm, swidm/rwidm, ssupm/rsupm, and ssubm/rsubm pairs. 


Note that terminfo also has a capability for printing emboldened text (bold). 
While shadow printing and emboldened printing are similar in that they 
darken the text, many printers produce these two types of print in slightly dif- 
ferent ways. Generally, emboldened printing is done by overstriking the same 
character one or more times. Shadow printing likewise usually involves over- 
striking, but with a slight movement up and/or to the side so that the charac- 
ter is fatter. 


It is assumed that enhanced printing modes are independent modes, so that it 
would be possible, for instance, to shadow print italicized subscripts. 


As mentioned earlier, the amount of motion automatically made after printing 
@ wide character should be given in wides. 


If only a subset of the printable ASCII characters can be printed as super- 
scripts or subscripts, they should be listed in supes or subes strings, respec- 
tively. If the ssupm or ssubm strings contain control sequences, but the cor- 
responding supes or subes strings are empty, it is assumed that all printable 
ASCII characters are available as superscripts or subscripts. 


Automatic motion made after printing a superscript or subscript is assumed to 
be the same as for regular characters. Thus, for example, printing any of the 
following three examples will result in equivalent motion: Bi B, B 


Note that the existing msgr boolean capability describes whether motion con- 
trol sequences can be used while in “standout mode.” This capability is 
extended to cover the enhanced printing modes added here. msgr should be 
set for those printers that accept any motion control sequences without affect- 
ing shadow, italicized, widened, superscript, or subscript printing. Con- 
versely, if msgr is not set, a program should end these modes before 
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attempting any motion. 


Section 2-5 Alternate Character Sets 


In addition to allowing you to define line graphics Custis in Section 1-12), 
terminfo lets you define alternate character sets. The following capabilities 
cover printers and terminals with multiple selectable or definable character 
sets. = 


Alternate Character Sets 
scs Select character set N 


sesd Start definition of character set N, M characters 
defc Define character A, B dots wide, descender D 
resd End definition of character set N 


esnm List of character set names 
daisy Printer has manually changed print-wheels 


The ses, resd, and csnm strings are used with a single argument, N, a num- 
ber from 0 to 63 that identifies the character set. The sesd string is also used 
with the argument N and another, M, that gives the number of characters in 
the set. The defe string is used with three arguments: A gives the ASCII 
code representation for the character, B gives the width of the character in 
dots, and D is zero or one depending on whether the character is a “descender” 
or not. The defe string is also followed by a string of “image-data” bytes that 
describe how the character looks (see below). 


Character set 0 is the default character set present after the printer has been 
initialized. Not every printer has 64 character sets, of course; using ses with 
an argument that doesn’t select an available character set should cause a null 
result from tparm(). 


Ifa character set has to be defined before it can be used, the scsd control 
sequence is to be used before defining the character set, and the resd is to be 
used after. They should also cause a null result from tparm () when used with 
an argument N that doesn’t apply. Ifa character set still has to be selected 
after being defined, the scs control sequence should follow the resd control 
sequence. By examining the results of using each of the scs, sesd, and resd 
strings with a character set number in a call to tparm(), a program can deter- 
mine which of the three are needed. 


Between use of the sesd and resd strings, the defe string should be used to 
define each character. To print any character on printers covered by terminfo, 
the ASCII code is sent to the printer. This is true for characters in an alter- 
nate set as well as normal characters. Thus the definition of a character 
includes the ASCII code that represents it. In addition, the width of the char- 
acter in dots is given, along with an indication of whether the character 
should descend below the print line (such as the lower case letter g in most 
character sets). The width of the character in dots also indicates the number 
of image-data bytes that will follow the defe string. These image-data bytes 
indicate where in a dot-matrix pattern ink should be applied to draw the char- 
acter; the number of these bytes and their form are defined below under Dot- 
Mapped Graphics. 
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It’s easiest for the creator of terminfo entries to refer to each character set by 
number; however, these numbers are meaningless to the application devel- 
oper. The esnm string alleviates this problem by providing names for each 

* number. 


When used with a character set number in a call to tparm(), the csnm string 
produces the equivalent name. These names should be used as a reference 
only. No naming convention is implied, although anyone who creates a ter- 
minfo entry for a printer should use names consistent with the names found in 
user documents for the printer. Application developers should allow a user to 
specify a character set by number (leaving it up to the user to examine the 
esnm string to determine the correct number), or by name, where the applica- 
tion examines the csnm string to determine the corresponding character set 
number. 


These capabilities are likely to be used only with dot-matrix printers. If they 
are not available, the strings should not be defined. For printers that have 
manually changed print-wheels or font cartridges, the boolean daisy is set. 


Section 2-6 Dot-Matrix Graphics 
Dot-matrix printers typically have the capability of reproducing raster-graph- 
ics images. Three new numeric capabilities and three new string capabilities 
can help a program draw raster-graphics images independent of the type of 
dot-matrix printer or the number of pins or dots the printer can handle at one 
time. 


Dot-Matrix Graphics 


npins Number of pins, N, in print-head 

spinv Spacing of pins vertically in pins per inch 
spinh Spacing of dots horizontally in dots per inch 
porder Matches software bits to print-head pins 
sbim Start printing bit image graphics, B bits wide 
rbim End printing bit image graphics 


The sbim sring is used with a single argument, B, the width of the image in 
dots. 


The model of dot-matrix or raster-graphics that terminfo presents is similar to 
the technique used for most dot-matrix printers: each pass of the printer’s 
print-head is assumed to produce a dot-matrix that is N dots high and B dots 
wide. This is typically a wide, squat, rectangle of dots. The height of this rec- 
tangle in dots varies from one printer to the next; this is given in the npins 
numeric capability. The size of the rectangle in fractions of an inch also 
varies; it can be deduced from the spinv and spinh numeric capabilities. 
With these three values an application can divide a complete raster-graphics 
image into several horizontal strips, perhaps interpolating to account for dif- 
ferent dot spacing vertically and horizontally. 


The sbim and rbim strings are used to start and end a dot-matrix image, 
respectively. The sbim string is used with a single argument that gives the 
width of the dot-matrix in dots. A sequence of “image-data bytes” are sent to 
the printer after the sbim string and before the rbim string. The number of 
bytes is a integral multiple of the width of the dot-matrix; the multiple and 
the form of each byte is determined by the porder string as described below. 
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The porder string is a comma separated list of pin numbers optionally fol- 
lowed by an numerical offset. The offset, if given, is separated from the list 
with a semicolon. The position of each pin number in the list corresponds to a 
bit in an 8-bit data byte. The pins are numbered consecutively from 1 to 
npins, with 1 being the top pin. Note that the term pin is used loosely here; 
ink-jet dot-matrix printers don’t have pins, but can be considered to have an 
equivalent method of applying a single dot of ink to paper. The bit positions in 
porder are in groups of 8, with the first position in each group the most signif- 
icant bit and the last position the least significant bit. An application pro- 
duces 8-bit bytes in the order of the groups in porder. 


An application computes the image-data bytes from the internal image, map- 
ping vertical dot positions in each print-head pass into 8-bit bytes, using a1 
bit where ink should be applied and 0 where no ink should be applied. This 
can be reversed (0 bit for ink, 1 bit for no ink) by giving a negative pin number. 
If a position is skipped in porder, a 0 bit is used. If a position has a lower case 
x instead of a pin number, a 1 bit is used in the skipped position. For consis- 
tency, a lower case o can be used to represent a 0 filled, skipped bit. There 
must be a multiple of 8 bit positions used or skipped in porder ; if not, 0 bits 
are used to fill the last byte in the least significant bits. The offset, if given, is 
added to each data byte; the offset can be negative. 


Some examples may help clarify the use of the porder string. The AT&T 470, 
AT&T 475 and C.Itoh 8510 printers provide eight pins for graphics. The pins 
are identified top to bottom by the 8 bits in a byte, from least significant to 
most. The porder strings for these printers would be 8,7,6,5,4,3,2,1 
The AT&T 478 and AT&T 479 printers also provide eight pins for graphics. 
However, the pins are identified in the reverse order. The porder strings for 
these printers would be 1,2,3,4,5,6,7,8 The AT&T 5310, AT&T 5320, 
DEC LA100, and DEC LN03 printers provide six pins for graphics. The pins 
are identified top to bottom by the decimal values 1, 2, 4, 8, 16 and 32. These 
correspond to the low six bits in an 8-bit byte, although the decimal values are 
further offset by the value 63. The porder string for these printers would be 
+,6,5,4,3,2, 1; 63 or alternately 0,0,6,5,4,3,2,1;63 


Section 2-7 Effect of Changing Printing Resolution 


If the control sequences to change the character pitch or the line pitch are 
used, the pin or dot spacing may change: 
Dot-Matrix Graphics 
Changing the Character/Line Pitches 


cpi Change character pitch 
cpix If set, cpi changes spinh 
Ipi Change line pitch 

Ipix If set, Ipi changes spinv 
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Programs that use cpi or Ipi should recalculate the dot spacing: 


Dot-Matrix Graphics 
Effects of Changing the Character/Line Pitches 
Before After 

Using cpi with cpix clear: 

spinh’ spinh 

Using cpi with cpix set: 

spinh’ spinh=spinh’- hs 
si pe orhi’ 

Using Ipi with Ipix clear: 

spinv’ spinv 

Using Ipi with Ipix set: 

spinv’ spinv=spinv’: ane 
PADV"SPIDY  orhi’ 

Using chr: 

spinh’ spinh 

Using evr: 

spinv’ spinv 


orhi’ and orhi are the values of the horizontal resolution in steps per inch, 
before using epi and after using epi, respectively. Likewise, orvi’ and orvi 
are the values of the vertical resolution in steps per inch, before using Ipi and 
after using lpi, respectively. Thus, the changes in the dots per inch for dot- 
matrix graphics follow the changes in steps per inch for printer resolution. 
Section 2-8 Print Quality 
Many dot-matrix printers can alter the dot spacing of printed text to produce 
near letter-quality printing or draft-quality printing. Usually it is important 
to be able to choose one or the other because the rate of printing generally 
falls off as the quality improves. There are three new strings used to describe 
these capabilities. 


Print Quality 
snlq Set near-letter quality print 
snrmq Set normal quality print 
sdrfq Set draft quality print 


The capabilities are listed in decreasing levels of quality. Ifa printer doesn’t 
have al] three levels, one or two of the strings should be left blank as appropri- 
ate. 
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Section 2-9 Printing Rate and Buffer Size 


FILES 


Because there is no standard protocol that can be used to keep a program syn- 
chronized with a printer, and because modern printers can buffer data before 
printing it, a program generally cannot determine at any time what has been 
printed. Two new numeric capabilities can help a program estimate what has 
been printed. 


- 


Print Rate/Buffer Size 
cps Nominal print rate in characters per second 


bufsz Buffer capacity in characters 


eps is the nominal or average rate at which the printer prints characters; if 
this value is not given, the rate should be estimated at one-tenth the prevail- 
ing baud rate. bufsz is the maximum number of subsequent characters buf- 
fered before the guaranteed printing of an earlier character, assuming proper 
flow control has been used. If this value is not given it is assumed that the 
printer does not buffer characters, but prints them as they are received. 


As an example, if a printer has a 1000-character buffer, then sending the 
letter a followed by 1000 additional characters is guaranteed to cause the 
letter a to print. If the same printer prints at the rate of 100 characters per 
second, then it should take 10 seconds to print all the characters in the buffer, 
less if the buffer is not full. By keeping track of the characters sent to a 
printer, and knowing the print rate and buffer size, a program can synchro- 
nize itself with the printer. 


Note that most printer manufacturers advertise the maximum print rate, not 

the nominal print rate. A good way to get a value to put in for cps is to gener- 
ate a few pages of text, count the number of printable characters, and then see 
how long it takes to print the text. 


Applications that use these values should recognize the variability in the print 
rate. Straight text, in short lines, with no embedded control sequences will 
probably print at close to the advertised print rate and probably faster than 
the rate in cps. Graphics data with a lot of control sequences, or very long 
lines of text, will print at well below the advertised rate and below the rate in 
cps. Ifthe application is using cps to decide how long it should take a printer 
to print a block of text, the application should pad the estimate. Ifthe applica- 
tion is using cps to decide how much text has already been printed, it should 
shrink the estimate. The application thus errs in favor of the user, who 
wants, above all, to see all the output in its correct place. 


/usr/lib/terminfo/?/+ | Compiled terminal description database 
/usr/lib/.COREterm/?/* Subset of compiled terminal description database 


/usr/lib/tabset/* Tab settings for some terminals, in a format appro- 
priate to be output to the terminal (escape 
sequences that set margins and tabs) 


SEE ALSO 


tput(1), captoinfo(1M), infocmp(1M), tic(1M), printf(3S), curses(3X), term(5), 
tty(7) 
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WARNINGS 

As described in the Tabs and Initialization section above, a terminal’s initiali- 
zation strings, is], is2, and is3, if defined, must be output before a curses (3X) 

* program is run. An available mechanism for outputting such strings is tput 
init (see tput(1) and profile(4)). 
If a null character (\0) is encountered in a string, the null and all characters 
after it are lost. Therefore it is not possible to code a null character (\0) and 
send it to a device (either terminal or printer). The suggestion of sending a 
\0200, where a \0 (null) is needed can succeed only if the device (terminal or 
printer) ignores the eighth bit. For example, because all eight bits are used in 
the standard international ASCII character set, devices that adhere to this 
standard will treat \0200 differently from \0. 
Tampering with entries in /usr/lib/ .COREterm | ?/* or /usr/lib/terminfo/?/* 
(for example, changing or removing an entry) can affect programs such as vi(1) 
that expect the entry to be present and correct. In particular, removing the 
description for the dumb terminal causes unexpected problems. 
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NAME 


timezone — set default system time zone 
SYNOPSIS 


/etc/TIMEZONE 


DESCRIPTION 
This file sets and exports the time zone environment variable TZ. 


This file is used in other files that must know the time zone. 


The syntax of TZ is as follows: 


TZ 


dst_date 
date 


month 
week 

day 

letter 
hour 
minute 
second 
julianzero 
Jjulianone 
sign 


EXAMPLES 
Asimple /etc/ TIMEZONE file might look like the following: 


12/89 


# Time Zone 
TZ=ESTSEDT 
export TZ 


> 


Ld Ld 


bLeutbdsibud 


zone 
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| zone signed_time 
| zone signed_time zone 
| zone signed_time zone dst 


letter letter letter 
sign time 

| time 

hour 

| hour : minute 


| hour : minute : second 


signed_time 


| signed_time ; dst_date , dst_date 
| ; dst_date , dst_date 


date / time 
Jjulianone 
| julianzero 


ins R ~N 
sss. >= 


Asimple setting for New Jersey could be: 


TZ=ESTSEDT 


where EST is the abbreviation for the main time zone, 5 is the difference, in 
hours, between (UTC) (Universal Time Code, formerly Greenwich Mean Time) 
and the main time zone, and EDT is the abbreviation for the alternate time 


zone. 
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The most complex representation of the same setting, for the year 1986, is as 


follows: 7 ; © 
T2Z="EST5 :00: OOEDT4 :00:00;117/2:00:00,299/2:00:00" 


EST is the abbreviation for the main time zone, 5:00:00 is the difference, in 
hours, minutes, and seconds between UTC and the main time zone, EDT is the 
abbreviation for the alternate time zone, 4:00:00 is the difference, in hours, 
minutes, and seconds between UTC and the alternate time zone, 117 is the 
number of the day of the year (Julian day 0-365) when the alternate time zone 
will take effect, 2:00:00 is the number of hours, minutes, and seconds past 
midnight when the alternate time zone will take effect, 299 is the number of 
the day of the year when the alternate time zone will end, and 2:00:00 is the 
number of hours, minutes, and seconds past midnight when the alternate time 
zone will end. 


A southern hemisphere setting such as the Cook Islands could be as follows: 
TZ="KDT9 : 30KST10 :00; 64/5:00, 303/20:00" 


This setting means that KDT is the abbreviation for the main time zone, KST 
is the abbreviation for the alternate time zone, KST is 9 hours and 30 minutes 
later than UTC, KDT is 10 hours later than UTC, the starting date of KDT is 
the 64th day at 5 AM, and the ending date of KDT is the 303rd day at 8 PM. 
This TZ 

T2="ESTS5 :00: 00EDT4 :00:00;J117/2:00:00,3299/2:00:00" 
is exactly the same as the one given above, except the day of the year when 
the alternate timezone begins and ends is based on a different Julian number 
scheme. The Julian numbers have the range 1-365, and leap years are not 
taken into account. February 28 is day 59 and March 1 is day 60. It is impos- 
sible to explicitly refer to the occasional February 29. 
This TZ 

T2="EST5 :00: O0EDT4 :00:00;M3.2.0/2:00:00,M10.3.1/2:00:00" 
uses the third and final scheme of specifying the times for the alternative 
timezone beginning and ending. The beginning and ending days are specified 
as a floating day (Ex. The second Tuesday of March). The M says to use the 
floating scheme, followed by the month, week, and day. The example above 
gives the beginning day as the 2nd Sunday in March, and the ending day as 
the third Monday in October. A week value of 5 says to use the last week that 
contains the proper day. I.E. The last Tuesday of November would be M11.5.2 


Starting and ending times are relative to the alternate time zone. If the alter- 

nate time zone start and end dates and the time are not provided, the days for 7 
the United States that year are used and the time is 2 AM. Ifthe start and 

end dates are provided but the time is not provided, the time is midnight. 


Note that in most installations, TZ is set to the correct value by default when 
the user logs on, by the local /etc/ profile file (see profile(4)). 


NOTES 
When the longer format is used, TZ variable must be surrounded by double 
quotes as shown. 
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The system administrator must change the Julian start and end days annu- 
& ally if the longer form of the TZ variable is used. 


Setting the time during the interval of change from the main time zone to the 
alternate time zone or vice versa can produce unpredictable results. 


SEE ALSO 
re2(1M), ctime(3C), profile(4), environ(5) 
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NAME 
unistd — file header for symbolic constants 


SYNOPSIS 
#include <unistd.h> 


DESCRIPTION 
The header file <unistd.h> lists the symbolic constants and structures not 
already defined or declared in some other header file, as follows: 


/* Symbolic constants for the "access" routine: */ 


#define R_OK 4 /*Test for Read permission */ 
#define W_OK 2 /*Test for Write permission */ 
#define X_OK 1 /*Test for eXecute permission */ 
#define F_OK 0) /*Test for existence of File */ 


/*Unlock a previously locked region */ 
/*Lock a region for exclusive use */ 

/*Test and lock a region for exclusive use */ 
/*Test a region for other processes locks */ 


#define F_TLOCK 
#define F_TEST 


WNrRO 


/*Symbolic constants for the "lseek" routine: */ 


#define SEEK_SET 0 /* Set file pointer to "offset" */ 

#define SEEK_CUR 1 /* Set file pointer to current plus "offset" */ 
#define SEEK END 2 /* Set file pointer to EOF plus "offset" */ 
/*Pathnames:*/ 

#define GF_PATH /etc/group /*Pathname of the group file */ 

#define PF_PATH /etc/passwd/*Pathname of the passwd file */ 
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NAME 


UTMP(4) 


utmp, wtmp — utmp and wtmp entry formats 


SYNOPSIS 


#include <sys/types.h> , 
#include <utmp.h> 


DESCRIPTION 


These files, which hold user and accounting information for such commands as 
who(1), write(1), and login(1), have the following structure as defined by 
<utmp.h>: 


#define 
#define 
#define 


struct 


Me 


UTMP_FILE 
WIMP _FILE 
ut_name 


utmp { 

char 

char 

char 

short 

short 

struct 
short 
short 

} ut_exit; 


time_t 


"/etc/utmp" 
"/etc/wtmp" 
ut_user 


ut_user[8]; 

ut_id[4]; 

ut_line[12]; 

ut_pid; 

ut_type; 

exit_status { 
e_termination; 
e_exit; 


ut_time; 


/* Definitions for ut_type */ 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
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EMPTY 
RUN_LVL 
BOOT_TIME 
OLD_TIME 
NEW_TIME 


INIT_PROCESS 
LOGIN_PROCESS 
USER_PROCESS 
DEAD_PROCESS 


ACCOUNTING 
UTMAXTYPE 


0 


wo DWI nurse wWwne 


ACCOUNTING 


/* User login name */ 
/*/ etc/inittab ID (usually line #)*/ 


/* Device name (console, lnxx) */ 


/* Process ID */ 
/* Type of entry */ 


/* Proc termination status */ 
/* Process exit status */ 
/* The exit status of a process 


* marked as DEAD PROCESS. */ 


/* time entry was made */ 


/* 
/* 
/* 


/* 


Process spawned by "init" */ 
"getty" process waiting for login */ 
User process */ 


Largest legal value of ut_type */ 
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/* Special strings or formats used in the "ut_line" field when */ 
/* accounting for something.other than a process */ . 
/* No string for the ut_line field can be more than 11 chars + e/ 
“/* a NULL in length */ 

#define RUNLVL_MSG "run-level %c" 

#define BOOT_MSG "system boot" 

#define OTIME_MSG "old time” 

#define NTIME_MSG "new time” 


FILES 
/etc/utmp 
/etc/wtmp 


SEE ALSO 
login(1), who(1), write(1), getut(3C) 
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NAME 


UUCP(4) 


uucp — networking support files 
DESCRIPTION . 
The /usr/lib/uucp directory contains the Basic Networking Utilities support 
files. Changes to these files can be made using menus or by editing them man- 
ually. The support files are as follows: _ 


Devices 


Dialers 


Systems 


Dialcodes 


Permissions 


Poll 


Sysfiles 


SEE ALSO 


12/89 


re(4) 


Contains information concerning the location and line speed 
of the automatic call unit, direct links, and network devices. 


Contains character strings required to negotiate with net- 
work devices (automatic calling devices) in the establishment 
of connections to remote computers (non 801-type dialers). 


Contains information needed by the uucico daemon and the 
cu program to establish a link to a remote computer. It con- 
tains information such as the name of the remote computer, 
the name of the connecting device associated with the remote 
computer, when the computer can be reached, telephone num- 
ber, login ID, and password. 


Contains dial-code abbreviations that may be used in the 
phone number field of Systems file entries. 


Defines the level of access that is granted to computers when 
they attempt to transfer files or remotely execute commands 
on your computer. 


Defines computer that are to be polled by your system and 
when they are polled. 


Assigns different or multiple files to be used by uucico and 
cu as Systems, Devices, and Dialers. 


(5) Miscellaneous J 


snoauel|aosiw (S) J 
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NAME 
intro — introduction to miscellany 


DESCRIPTION 
This section describes miscellaneous facilities such as macro packages, charac- 
ter set tables, and so forth. 
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NAME 
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ascii — map of ASCII character set 
DESCRIPTION 


ASCII(5) 


ascii is a map of the ASCII character set, giving both octal and hexadecimal 


equivalents of each character, to be printed as needed. It contains: 


000 
010 
020 
030 
040 
050 
060 


nul 
bs 
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ENVIRON(5) 


environ — user environment 


DESCRIPTION 
An array of strings called the environment is made available by exec(2) when 
a process begins. By convention, these strings have the form name=value. 
The following names, also called environment variables or shell variables, are 
used by various commands: 


CFTIME 


CHRCLASS 


HOME 


LANGUAGE 


PATH 


The default format string to be used by the date(1) command and 
the ascftime() and cftime() routines (see ctime(3C)). If 
CFTIME is not set or is NULL, the default format string specified 
in the /lib/cftime/LANGUAGE file (if it exists) is used in its place 
(see cftime(4)). 


A value that corresponds to a file in /lib/chrelase containing 
character classification and conversion information. This infor- 
mation is used by commands (such as cat(1), ed(1), or sort(1)), to 
classify characters as alphabetic, printable, uppercase, and so 
forth, and to convert characters to uppercase or lowercase. 


When a program or command begins execution, the tables con- 
taining this information are initialized based on the value of 
CHRCLASS. If CHRCLASS is non-existent, null, set to a value for 
which no file exists in /lib/chrelass, or errors occur while read- 
ing the file, the ASCII character set is used. During execution, a 
program or command can change the values in these tables by 
calling the setchrclass() routine. For more detail, see 
ctype(3C). 

These tables are created using the chrtbl(1M) command. 


The name of the user’s login directory, set by login(1) from the 
password file (see passwd(4)). 


A language for which a printable file by that name exists in 
/lib/cftime. This information is used by commands (such as 
date(1), 1s(1), and sort(1)), to print date and time information in 
the language specified. 


If LANGUAGE is non-existent, NULL, set to a value for which no 
file exists in /lib/cftime, or errors occur while reading the file, 
the last language requested will be used. (If no language has 
been requested, the language usa_english is assumed.) For a 
description of the content of files in /lib/cftime, refer to 
cftime(4). 


The sequence of directory prefixes that sh(1), time(1), nice(1), 
nohup(1), and so forth, apply in searching for a file known by an 
incomplete path name. The prefixes are separated by colons. 
login(1) sets PATH=: /bin:/usr/bin(see sh(1)). 

The kind of terminal for which output is to be prepared. This 
information is used by commands, such as mm(1) or vi(1), which 
may exploit special capabilities of that terminal. 
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TZ Time zone information. The simplest format is xxxnzzz where 
xxx is the standard local time zone abbreviation, n is the differ- 
ence in hours from UTC (Universal Time Code, formerly 
Greenwich Mean Time), and zzz is the abbreviation for an alter- 
nate time zone (usually the daylight-saving local time zone), if 
any; for example, 


TZ="ESTSEDT" 


The most complex format allows you to specify the difference in 
hours of the alternate time zone from UTC and the starting day 
and time and ending day and time for using this alternate time 
zone. For example, in 1985 the complex format corresponding to 
the simple example above is as follows: 


TZ="EST5: 00: 00EDT4:00:00;118/2:00:00,300/2:00:00" 


When the complex format is used, it must be surrounded by 
double quotes (see ctime(3C) and timezone(4)). 


Further names may be placed in the environment by the export command and 
name=value arguments in sh(1), or by exec(2). It is unwise to conflict with 
certain shell variables that are frequently exported by .profile files: MAIL, 
PS1, PS2, IFS (see profile(4)). 


NOTES 
Administrators should note the following: if you attempt to set the current 
date to one of the dates that the standard and alternate time zones change (for 
example, the date that daylight time is starting or ending), and you attempt to 
set the time to a time in the interval between the end of standard time and 
the beginning of the alternate time (or the end of the alternate time and the 
beginning of standard time), the results are unpredictable. 

SEE ALSO 
mm (1), cat(1), date(1), ed(1), env(1), 18(1), login(1), nice(1), nohup(1), sh(1), 
sort(1), time(1), vi(1), chrtbl(1M), cftime(4), passwd(4), profile(4), timezone(4), 
exec(2), ctime(3C), ctype(3C) 
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NAME 


& fent] — file control options 
SYNOPSIS 


#include <fentl.h> 


DESCRIPTION 
The fentl(2) function provides for control over open files. This include file 
describes requests and arguments to fcntl and open(2). 


/* Flag values accessible to open(2) and fentl(2) */ 
/* (The first three can as be set by open) +/ 
#define O_RDONLY 

#define O_WRONLY i 


#define O_RDWR 2 

#define O_NDELAY 04 /*Non-blocking I/o */ 

#define O APPEND 010 /*append (writes guaranteed at end) */ 
#define O SYNC 020 /* synchronous write option */ 


/* Flag values accessible only to open(2) */ 

#define O_CREAT 00400 /*open with file create (uses 3rd open arg)*/ 
#define O_TRUNC 01000 /*open with truncation */ 

#define O EXCL 02000 /*exclusive open */ 


/* fent1(2) requests */ 
#define F_DUPFD 0 /*Duplicate fildes */ 
#define F_GETFD 1 /*Get fildes flags */ 

@ #define F_SETFD 2 /*Set fildes flags */ 
#define F_GETFL 3 /*Get file flags */ 
#define F_SETFL 4 /*Set file flags */ 
#define F_GETLK 5 /*Get file lock */ 
#define F_SETLK 6 /*Set file lock */ 
#define F_SETLKW 7 /*Set file lock and wait */ 


/* file segment locking control structure */ 
struct flock { 

short 1_type; 

short 1_ whence; 

long 1_start; 


long 1_len; /*if 0 then until EOF */ 
short 1_sysid; /*returned with F_GETLK*/ 
short 1 pid; /*returned with F_GETLK*/ 


} 


/* file segment locking types */ 
#define F_RDLCK 01 /*Read lock */ 
#define F_WRLCK 02 /*Write lock */ 
#define F_UNLCK 03 /*Remove locks */ 


SEE ALSO 


© fentl(2), open(2) 
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NAME 
math — math functions and constants 


SYNOPSIS 
#include <math.h> 


DESCRIPTION 
This file contains declarations of all the functions in the Math Library 
(described in Section 3M), as well as various functions in the C Library (Sec- 
tion 3C) that return floating-point values. 


It defines the structure and constants used by the matherr(3M) error-hand- 
ling mechanisms, including the following constant used as an error-return 
value: 


HUGE The maximum value of a single-precision floating-point 
number. 


The following mathematical constants are defined for user convenience: 


M_E The base of natural logarithms (e). 

M_LOG2E The base-2 logarithm of e. 

M_LOGIOE The base-10 logarithm of e. 

M_LN2 The natural logarithm of 2. 

M_LNIO The natural logarithm of 10. 

M_PI , the ratio of the circumference of a circle to its diame- 
ter. 

M_PL2 wW2. 

M_PI_4 wa4, 

M1_PI Un. 

M_2_PI Wn. 

M_2_SQRTPI QNn. 

M_SQRT2 The positive square root of 2. 

M_SQRT1_2 The positive square root of 1/2. 


For the definitions of various machine-dependent constants, see the descrip- 
tion of the <values.h> header file. 


SEE ALSO 
intro(3), matherr(3M), values(5) 
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NAME 
prof — profile within a function 


SYNOPSIS 
#define MARK 
#include <prof.h> 


void MARK (name) 
DESCRIPTION 


PROF(5) 


MARE introduces a mark called name that is treated the same as a function 
entry point. Execution of the mark adds to a counter for that mark, and pro- 
gram-counter time spent is accounted to the immediately preceding mark or to 
the function if there are no preceding marks within the active function. 


name may be any combination of numbers or underscores. Each name ina 
single compilation must be unique, but may be the same as any ordinary pro- 


gram symbol. 


For marks to be effective, the symbol MARK must be defined before the header 
file <prof-h> is included. This may be defined by a preprocessor directive as in 


the synopsis, or by a command line argument, i.e: 


cc -p —-DMARK foo.c 


If MARK is not defined, the MARK (name) statements may be left in the source 


files containing them and are ignored. 


EXAMPLES 


In this example, marks can be used to determine how much time is spent in 
each loop. Unless this example is compiled with MARK defined on the com- 


mand line, the marks are ignored. 


#include <prof.h> 


foo( ) 

{ 
int i, j3 
MARK (loop1) ; 
for (i = O; i < 2000; 
} 
MARK (loop2) ; 
for (j = 0; j < 2000; 
} 

} 

SEE ALSO 


prof(1), profil(2), monitor(3C) 
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NAME 


regexp — regular expression compile and match routines 


SYNOPSIS 


#define INIT <declarations> 

#define GETC() <getc code> 

#define PEEKC() <peeke code> 

#define UNGETC(c) <ungetc code> 
#define RETURN(pointer) <return code> 
#define ERROR(val) <error code> 


#include <regexp.h> 


char *compile (instring, expbuf, endbuf, eof) 
char *instring, *expbuf, *endbuf; 
int eof; 


int step (string, expbuf) 
char *string, *expbuf; 


extern char *locl, +loc2, +locs; 
extern int circf, sed, nbra; 


DESCRIPTION 
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This page describes general-purpose regular expression matching routines in 
the form of ed(1), defined in <regexp.h>. Programs such as ed(1), sed(1), 
grep(1), bs(1), and expr(1), which perform regular expression matching, use 
this source file. In this way, only this file need be changed to maintain regular 
expression compatibility. 

The interface to this file is complex. Programs that include this file must have 
the following five macros declared before the #include <regexp.h> state- 
ment. These macros are used by the compile routine: 


GETC() Return the value of the next character in the regular 
expression pattern. Successive calls to GETC() should 
return successive characters of the regular expression. 


PEEKC() Return the next character in the regular expression. 
Successive calls to PEEKC() should return the same 
character [which should also be the next character 
returned by GETC()]. 


UNGETC(c ) Cause the argument c to be returned by the next call to 
GETC() and PEEKC(). No more that one character of 
pushback is ever needed and this character is 
guaranteed to be the last character read by GETC(). 
The value of the macro UNGETC(c) is always ignored. 


RETURN(pointer) This macro is used on normal exit of the compile rou- 
tine. The value of the argument pointer is a pointer to 
the character after the last character of the compiled 
regular expression. This is useful to programs which 
have memory allocation to manage. 


ERROR(val) This is the abnormal return from the compile routine. 
The argument val is an error number as listed in the 
following table. This call should never return. 
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ERROR MEANING 

11 Range endpoint too large. 

16 Bad number. 

25 “\digit” out of range. 

36 Illegal or missing delimiter. 

41 No remembered search string. 

42 \(C \) imbalance. 

43 Too many \(. 

44 More than 2 numbers given in \{ \}. 
45 } expected after \. 

46 First number exceeds second in \{ \}. 
49 [] imbalance. 

50 Regular expression overflow. 


The syntax of the compile routine is as follows: 
compile(instring, expbuf, endbuf, eof) 


The first parameter instring is never used explicitly by the compile routine 
but is useful for programs that pass down different pointers to input charac- 
ters. It is sometimes used in the INIT declaration (see below). Programs 
which call functions to input characters or have characters in an external 
array can pass down a value of ((char *) 0) for this parameter. 


The next parameter expbuf is a character pointer. It points to the place 
where the compiled regular expression will be placed. 


The parameter endbuf is one more than the highest address where the com- 
piled regular expression may be placed. If the compiled expression cannot fit 
in (endbuf—expbuf) bytes, a call to ERROR(50) is made. 


The parameter eof is the character which marks the end of the regular 
expression. For example, in ed(1), this character is usually a /. 


Each program that includes this file must have a #define statement for INIT. 
This definition will be placed right after the declaration for the function com- 
pile and the opening curly brace ({). It is used for dependent declarations and 
initializations. Most often it is used to set a register variable to point the 
beginning of the regular expression so that this register variable can be used 
in the declarations for GETC(), PEEKC() and UNGETC(). Otherwise it can be 
used to declare external variables that might be used by GETC(), PEEKC() 
and UNGETC(). See the example below of the declarations taken from 
grep(1). 


There are other functions in this file which perform actual regular expression 
matching, one of which is the function step. The call to step is as follows: 


step(string, expbuf) 


The first parameter to step is a pointer to a string of characters to be checked. 
for a match. This string should be null terminated. 


The second parameter expbuf is the compiled regular expression which was 
obtained by a call of the function compile. 


The function step returns non-zero if the given string matches the regular 
expression, and zero if the expressions do not match. If there is a match, two 
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external character pointers are set as a side effect to the call to step. The 
variable set in step is locL This is a pointer to the first character that 
matched the regular expression. The variable loc2, which is set by the func- 
tion advance, points to the character after the last character that matches 
the regular expression. Thus if the regular expression matches the entire 
line, loc1 will point to the first character of string and loc2 will point to the 
null at the end of string. 


step uses the external variable ciref which is set by compile if the regular 
expression begins with ~. If this is set then step will try to match the regular 
expression to the beginning of the string only. If more than one regular 
expression is to be compiled before the first is executed the value of circf 
should be saved for each compiled expression and ciref should be set to that 
saved value before each call to step. 


The function advance is called from step with the same arguments as step. 
The purpose of step is to step through the string argument and call 
advance unti] advance returns non-zero indicating a match or until the end 
of string is reached. If one wants to constrain string to the beginning of the 
line in all cases, step need not be called; simply call advance. 


When advance encounters a * or \{ \} sequence in the regular expression, it 
will advance its pointer to the string to be matched as far as possible and will 
recursively call itself trying to match the rest of the string to the rest of the 
regular expression. As long as there is no match, advance will back up along 
the string until it finds a match or reaches the point in the string that initially 
matched the * or \{ \}. It is sometimes desirable to stop this backing up 
before the initial point in the string is reached. If the external character 
pointer locs is equal to the point in the string at sometime during the backing 
up process, advance breaks out of the loop that backs up and returns zero. 
This is used by ed(1) and sed(1) for substitutions done globally (not just the 
first occurrence, but the whole line) so, for example, expressions like s/y*//g do 
not loop forever. 


The additional external variables sed and nbra are used for special purposes. 


EXAMPLES 


The following is an example of how the regular expression macros and calls 
look from grep(1): 


#define INIT register char *sp = instring; 


#define GETC() (*sp +) 
#define PEEKC() (*sp) 
#define UNGETC(c) (--sp) 
#define RETURN(c) return; 
#define ERROR (c) regerr() 


#include <regexp.h> 
(void) compile (*argv, expbuf, &expbuf[ESIzE], \0’); 


if (step(linebuf, expbuf) ) 


succeed (); 
eS SEE ALSO 
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ed(1), expr(1), grep(1), sed(1) 
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NAME 


STAT(5) 


stat — data returned by stat system call 


SYNOPSIS 


#include <sys/types.h> 


#include <sys/stat.h> 


DESCRIPTION 


The system calls stat and fstat return data whose structure is defined by this 
include file. The encoding of the field st_mode is defined in this file also. 


Structure of the result of stat 


struct 


{ 


stat 


dev_t 


ino_t 


mode_t 
nlink_t 
uid_t 
gid_t 
dev_t 
off_t 


Me 


#define . 
#define — 
#define . 
#define — 
#define— 
#define — 
#define — 
#define — 
#define — 
#tdefine 
#define — 
#define — 
#define — 
#define — 
#define — 
#define — 
#define — 
#define ~ 
#define — 
#define — 
‘#define — 
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0170000 
0040000 
0020000 
0060000 
0100000 
0010000 
0120000 
04000 
02000 
01000 
00400 
00200 
00100 
s_ISGID 
00700 
00400 
00200 
00100 
00070 
00040 
00020 


st_dev; 
st_ino; 
st_mode; 
st_nlink; 
st_uid; 
st_gid; 
st_rdev; 
st_size; 
timeval_t st_atime; 
timeval_t st_mtime; 
timeval_t st_ctime; 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
[* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


type of file */ 

directory */ 

character special */ 

block special */ 

regular */ 

fifo */ 

symbolic link */ 

set user ID on execution */ 

set group ID on execution */ 

save swapped text even after use */ 
read permission, owner */ 

write permission, owner */ 
execute/search permission, owner */ 
record locking enforcement flag */ 
read,write, execute: owner */ 

read permission: owner */ 

write permission: owner */ 
execute permission: owner */ 

read, write, execute: group */ 
read permission: group */ 

write permission: group */ 


STAT(5) 


#define ~ 00010 
#define ~ 00007 
#define ~ 00004 
#define ~ 00002 
#define ~ 00001 


SEE ALSO 
stat(2), types(5) 


/* 
[* 
/* 
/* 
/* 


execute permission: group */ 
read, write, execute: other */ 
read permission: other */ 
write permission: other */ 
execute permission: other */ 


DYNIX/ptx 
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term — conventional names for terminals 


DESCRIPTION 


These names are used by certain commands (for example man(1), tabs(1), 
tput(1), vi(1) or curses(3X)), and are maintained as part of the shell environ- 
ment in the environment variable TERM (see sh(1), profile(4), and envi- 
ron(5)). 


Entries in terminfo(4) source files consist of a number of comma-separated 
fields. (To obtain the source description for a terminal, use the -I option of 
infocmp(1M).) White space after each comma is ignored. The first line of 
each terminal description in the terminfo(4) database gives the names by 
which terminfo(4) knows the terminal, separated by bar (| ) characters. The 
first name given is the most common abbreviation for the terminal (this is the 
one to use to set the environment variable TERMINFO in $HOME/.profile; see 
profile(4)), the last name given should be a long name fully identifying the 
terminal, and all others are understood as synonyms for the terminal name. 
All names but the last should contain no blanks and must be unique in the 
first 14 characters; the last name may contain blanks for readability. 


Terminal names (except for the last, verbose entry) should be chosen using the 
following conventions. The particular piece of hardware making up the termi- 
nal should have a root name chosen, for example, for the AT&T 4425 terminal, 
att4425. This name should not contain hyphens, except that synonyms may 
be chosen that do not conflict with other names. Up to 8 characters, chosen 
from [a—z0—9], make up a basic terminal name. Names should generally be 
based on original vendors, rather than local distributors. A terminal acquired 
from one vendor should not have more than one distinct basic name. Termi- 
nal sub-models, operational modes that the hardware can be in, or user prefer- 
ences, should be indicated by appending a hyphen and an indicator of the 
mode. Thus, an AT&T 4425 terminal in 132 column mode would be 
att4425-w. The following suffixes should be used where possible: 


Suffix Meaning Example 
-w Wide mode (more than 80 columns) att4425-w 
-am With auto. margins (usually default) vt100—am 
-nam Without automatic margins vt100-nam 
nn Number of lines on the screen aaa-60 
-na No arrow keys (leave them in local) c100-na 
—np Number of pages of memory c100-4p 
-rv Reverse video att4415-rv 


To avoid conflicts with the naming conventions used in describing the differ- 
ent modes of a terminal, for example, —w, it is recommended that a terminal’s 
root name not contain hyphens. Further, it is good practice to make all termi- 
nal names used in the terminfo(4) database unique. Terminal entries that are 
present only for inclusion in other entries via the use= facilities should have a 
4’ in their name, as in 4415+nl 


Some of the known terminal names may include the following (for a complete 
list, type: 1s -C /usr/lib/terminfo/?": 


2621,hp2621 Hewlett-Packard 2621 series 
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2631 
2631-c 


2631-e 


2640,hp2640 
2645,hp2645 
3270 
33,tty33 
35,tty35 
37,tty37 
4000a 
4014,tek4014 
40,tty40 
43,tty43 
4410,5410 


4410-nfk,5410-nfk 


4410-nsl,5410-nsl 
4410—-w,5410—w 
4410v1,5410v1 


4410v1—w,5410v1—w 


4415,5420 
4415-nl,5420-nl 
4415-rv,5420-rv 
4415-rv—nl,5420-rv—nl 


4415—w,5420-w 
4415—w-—nl,5420—w-—nl 


4415—w-rv,5420—w-rv 
4415—w-rv_—nl,5420—w-rv—nl 


4418,5418 
4418-w,5418-w 
4420 

4424 

4424-2 


4425,5425 
4425-fk,5425-fk 
4425-nl,5425-nl 


4425-w,5425—w 
4425-w-fk,5425-w-fk 
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Hewlett-Packard 2631 line printer 

Hewlett-Packard 2631 line printer - 
compressed mode 

Hewlett-Packard 2631 line printer - 
expanded mode 

Hewlett-Packard 2640 series 

Hewlett-Packard 2645 series 

IBM Model 3270 

AT&T Teletype Model 33 KSR 

AT&T Teletype Model 35 KSR 

AT&T Teletype Model 37 KSR 

Trendata 4000a 

TEKTRONIX 4014 

AT&T Teletype Dataspeed 40/2 

AT&T Teletype Model 43 KSR 

AT&T 4410/5410 terminal in 80-column mode - 
version 2 

AT&T 4410/5410 without function keys - 
version 1 

AT&T 4410/5410 without pln defined 

AT&T 4410/5410 in 132-column mode 

AT&T 4410/5410 terminal in 80-column mode - 
version 1 

AT&T 4410/5410 terminal in 132-column mode - 
version 1 

AT&T 4415/5420 in 80-column mode 

AT&T 4415/5420 without changing labels 

AT&T 4415/5420 80 columns in reverse video 

AT&T 4415/5420 reverse video 
without changing labels 

AT&T 4415/5420 in 132-column mode 

AT&T 4415/5420 in 132-column mode 
without changing labels 

AT&T 4415/5420 132 columns in reverse video 

AT&T 4415/5420 132 columns reverse 
video without changing labels 

AT&T 5418 in 80-column mode 

AT&T 5418 in 132-column mode 

AT&T Teletype Model 4420 

AT&T Teletype Model 4424 

AT&T Teletype Model 4424 in display function 
group ii 

AT&T 4425/5425 

AT&T 4425/5425 without function keys 

AT&T 4425/5425 without changing labels 
in 80-column mode 

AT&T 4425/5425 in 132-column mode 

AT&T 4425/5425 without function keys 
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4425—nl—w,5425—nl_w 


4426 

450 

450-12 
500,att500 
510,510a 
513bet,att513 
5320 

5420_2 

5420_2-w 
5620,dmd 
5620-24,dmd-—24 
5620-34,dmd-—34 » 
610,610bet 
610-w,610bct—w 
7300,pc7300,unix_pe 
735,ti 
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in 132-column mode 
AT&T 4425/5425 without changing labels 
in 132-column mode 
AT&T Teletype Model 4426S 
DASI 450 (same as Diablo 1620) 
DASI 450 in 12-pitch mode 
AT&T-IS 500 terminal 
AT&T 510/510a in 80-column mode 
AT&T 513 bet terminal 
AT&T 5320 hardcopy terminal 
AT&T 5420 model 2 in 80-column mode 
AT&T 5420 model 2 in 132-column mode 
AT&T 5620 terminal 88 columns 
AT&T Teletype Model DMD 5620 in a 24x80 layer 
AT&T Teletype Model DMD 5620 in a 34x80 layer 
AT&T 610 bet terminal in 80-column mode 
AT&T 610 bet terminal in 132-column mode 
AT&T UNIX PC Model 7300 
Texas Instruments T1735 and T1725 
Texas Instruments TI745 
generic name for terminals that lack reverse 
line-feed and other special escape sequences 
Hewlett-Packard (same as 2645) 
generic name for a line printer 
AT&T Personal Terminal 505 (22 lines) 
AT&T Personal Terminal 505 (24-line mode) 
generic name for synchronous Teletype Model 
4540-compatible terminals 


Commands whose behavior depends on the type of terminal should accept 
arguments of the form ~-T term where term is one of the names given above; 
if no such argument is present, such commands should obtain the terminal 
type from the environment variable TERM, which, in turn, should contain 


term. 


FILES 


/usr/lib/termin*’?/* 


SEE ALSO 
man(1), sh(1), stty(1), tabs(1), tput(1), vi(1), tplot(1G), infocmp(1M), curses(3X), 
profile(4), terminfo(4), environ(5) 


NOTES 
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compiled terminal description database 


Not all programs follow the above naming conventions. 
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types — primitive system data types 
SYNOPSIS 
#include <sys/types.h> 


DESCRIPTION 
The data types defined in the include file are used in operating system code; 
some data of these types are accessible to user code: 


typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 


struct physadr { int r[{1]; } *physadr; 
struct quad { long val[2]; } quad; 


long daddr _t; 
char * caddr_t; 
unsigned char 
unsigned short 
unsigned int 
unsigned long 

ulong ino_t; 
short ent_t; 
long time_t; 
long dev_t; 
long off _t; 
long paddr_t; 
int key_t; 
unchar use_t; 
short sysid_t; 
short index_t; 
unchar lock_t; 
uint size_t; 
int bool_t; 
int spl_t; 
long swblk_t; 
short pid_t; 
unsigned short 
unsigned short 
unsigned short 
unsigned char 

short nlink_t; 
struct list { 


struct list *1_flink; 
struct list *l_rlink; 


} 


list_t; 


typedef struct label t { 
int 
int 
int 
int 
int 
int 


} label t; 
typedef struct { 


int 


lt_esp; 
1lt_ebp; 
lt_eip; 
1lt_ebx; 
lt_esi; 
1t_edi; 


*s_ head; 


unchar; 
ushort; 
uint; 
ulong; 


gid_t; 
uid_t; 
mode_t; 
gate_t; 
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int *s_tail; 

short s_count; 

gate_t s_gate; 

char s_flags; 

struct semstat { 
ulong ss_visit; 
ulong ss_block; 
ulong ss_totqlen; 
} s_semstat; 

} sema_t; 


typedef struct { 
time_t tv_sec; 
time_t tv_usec; 
} timeval_t; 


The form daddr_t is used for disk addresses except in an inode on disk, see 
fe(4). Times are encoded in seconds since 00:00:00 UTC, January 1, 1970. The 
major and minor parts of a device code specify kind and unit number of a 
device and are installation-dependent. Offsets are measured in bytes from the 
beginning of a file. The label_t variables are used to save the processor state 
while another process is running. 


SEE ALSO 
fs(4) 
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NAME 


values — machine-dependent values 


SYNOPSIS 


#include <values.h> 


DESCRIPTION 


This file contains a set of manifest constants, conditionally defined for particu- 
lar processor architectures. 


The model assumed for integers is binary representation (one’s or two’s com- 
plement), where the sign is represented by the value of the high-order bit. 


BITS(type) The number of bits in a specified type (e.g., int). 

HIBITS The value of a short integer with only the high-order bit 
set (eg 0x8000 for 16 bit shorts). 

HIBITL The value of a long integer with only the high-order bit 
set (eg 0x80000000 for 32 bit integers). 

HIBITI The value of a regular integer with only the high-order 
bit set (usually the same as HIBITS or HIBITL). 

MAXSHORT The maximum value of a signed short integer (eg 
0x7FFF = 32767 for 16 bit 2’s complement). 

MAXLONG The maximum value of a signed long integer (eg 
0x7FFFFFFF = 2147483647 for 32 bit 2’s complement). 

MAXINT The maximum value of a signed regular integer (usually 


the same as MAXSHORT or MAXLONG). 


MAXFLOAT, LN_MAXFLOAT 
The maximum value of a single-precision floating-point 
number, and its natural logarithm. 
MAXDOUBLE, LN_MAXDOUBLE 
The maximum value of a double-precision floating-point 
number, and its natural logarithm. 
MINFLOAT, LN_MINFLOAT 
The minimum positive value of a single-precision float- 
ing-point number, and its natural logarithm. 
MINDOUBLE, LN_MINDOUBLE 
The minimum positive value of a double-precision float- 
ing-point number, and its natural logarithm. 


FSIGNIF The number of significant bits in the mantissa of a 
single-precision floating-point number. 
DSIGNIF The number of significant bits in the mantissa of a 


double-precision floating-point number. 


SEE ALSO 
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intro(3), math(5) 
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NAME 


varargs — handle variable argument list 


SYNOPSIS 


#include <varargs.h> 
va_alist 

va_dcl 

void va_start(pvar) 
va_list pvar; 

type va_arg(pvar, type) 
va_list pvar; 

void va_end(pvar) 
va_list pvar; 


DESCRIPTION 


This set of macros allows portable procedures that accept variable argument 
lists to be written. Routines that have variable argument lists (such as 
printf(3S)) but do not use varargs are inherently nonportable, as different 
machines use different argument-passing conventions. 


va_alist is used as the parameter list in a function header. 

va_dcl is a declaration for va_alist. No semicolon should follow va_del. 
va_list is a type defined for the variable used to traverse the list. 
va_start is called to initialize pvar to the beginning of the list. 


va_arg returns the next argument in the list pointed to by pvar. type is the 
type the argument is expected to be. Different types can be mixed, but it is up 
to the routine to know what type of argument is expected, as it cannot be 
determined at runtime. 


va_end is used to clean up. 
Multiple traversals, each bracketed by va_start ... va_end, are possible. 


EXAMPLES 
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This example is a possible implementation of execl(2). 


#include <varargs.h> 
#define MAXARGS 100 


/* execl is called by 


execl(file, argl, arg2, ..., (char *)0); 
*/ 
execl (va_alist) 
va_del 


{ 
va_list ap; 
char *file; 
char *args [MAXARGS]; 
int argno = 0; 


va_start (ap); 


VARARGS(5) DYNIX/ptx 


file = va_arg(ap, char *); 

while ((args[argnot+] = va_arg(ap, char *)) != (char *)0) 
va_end (ap); 

return execv(file, args); 


} 


SEE ALSO 
exec(2), printf{(3S), vprintf(3S) 


NOTES 
It is up to the calling routine to specify how many arguments there are, since 
it is not always possible to determine this from the stack frame. For example, 
execl is passed a zero pointer to signal the end of the list. printf can tell how 
many arguments are there by the format. 


It is non-portable to specify a second argument of char, short, or float to 
va_arg, since arguments seen by the called function are not char, short, or C 
converts char and short arguments to int and converts float arguments to 
double before passing them to a function. 
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NAME 


intro — introduction to special files 


@ DESCRIPTION - 
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This section describes various special files that refer to specific hardware 
peripherals, and operating system device drivers. STREAMS (see intro(2)) 
software drivers, modules and the STREAMS-generic set of ioctl(2) system 
calls are also described. 


For hardware related files, the names of the entries are generally derived from 
names for the hardware, as opposed to the names of the special files them- 
selves. Characteristics of both the hardware device and the corresponding 
operating system device driver are discussed where applicable. 


Disk device filenames are in the following format: 

/dev/{r} dsk/<driver-name><drive-number>{s<number>} 
where r indicates a raw interface to the disk, and s<number> indicates the 
section (slice) number of the partitioned device. For example, the root parti- 
tion on SCSI device 0 might be: 


/dev/dsk/sd0s0 


DYNIX/ptx CLONE(7) 


NAME 


clone — open any minor device on a STREAMS driver 


@ CONFIGURATION ENTRY 


pseudodevice clone 


DESCRIPTION 


clone is a STREAMS software driver that finds and opens an unused minor 
device on another STREAMS driver. The minor device passed to clone during 
the open is interpreted as the major device number of another STREAMS 
driver for which an unused minor device is to be obtained. Each such open 
results in a separate stream to a previously unused minor device. 


The clone driver consists solely of an open function. This open function per- 
forms all of the necessary work so that subsequent system calls (including 
close(2)) require no further involvement of clone. 


clone will generate an ENXIO error, without opening the device, if the minor 
device number provided does not correspond to a valid major device, or if the 
driver indicated is not a STREAMS driver. 


WARNINGS 


Multiple opens of the same minor device cannot be done through the clone 
interface. Executing stat(2) on the file system node for a cloned device yields 
a different result from executing fstat(2) using a file descriptor obtained from 
opening the node. 


SEE ALSO 
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NAME 


cmpt — compatibility partitioning driver 


CONFIGURATION ENTRY 


pseudodevice cmpt 


DESCRIPTION 
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This device driver provides compatibility disk partitioning, meaning that 
access is provided to the underlying disk space through partitions statically 
defined in the kernel. The partitions cannot be changed unless the kernel is 
relinked. The partition layout is compatible with that used by DYNIX V3.0. 
This is a virtual device driver, in that it requires an actual disk device (such as 
a zd, sd, or wd device) to build upon. 


Disk device drivers do not provide any partitions, but present the entire disk 
surface for use. To make this so-called unpartitioned disk more useful, the 
disk surface may be partitioned by the cmpt driver into up to 8 possibly over- 
lapping sections. Each of these disk sections is accessed with a separate minor 
number and each of these sections matches the disk partitions which were the 
default in DYNIX V3.0. 


Special files with minor device numbers 0 through 7 refer to various portions 
of drive 0; minor devices 256 through 263 refer to drive 1, and so forth. The 
special files with minor number 255 refers to drive 0 in the unpartitioned 
state, and is not accessible if a partitioning driver is in place on this disk. 
(The jump in minor numbers between drive 0 and drive 1 is due to support for 
the vtoc driver, which can support up to 255 partitions per disk.) The stan- 
dard device names begin with the disk controller name (e.g., zd or wd), fol- 
lowed by the drive number, followed by the letter s, and then a number from 
0-7 —e.g., zd0s0. By convention, these special files are found in the directory 
/dev/dsk. 


The block devices access the disk through the system’s normal buffering mech- 
anism and may be read and written without regard to physical disk records. 
There is also a raw interface that provides for direct transmission between the 
disk and the user’s read or write buffer. Raw transfers are limited to a maxi- 
mum raw transfer size. The maximum raw transfer size is specific to each 
driver, but is usually 256 512-byte sectors. In raw I/O, counts must be a mul- 
tiple of 512 bytes, and must begin on 16-byte aligned memory addresses. Like- 
wise, lseek calls should specify a multiple of 512 bytes. A single read or write 
call usually results in exactly one I/O operation, which transfers data directly 
to the user’s address space. Therefore, raw I/O is considerably more efficient 
when many words are transmitted. The names of the raw special files are con- 
ventionally the same as the block special files, and are found in the directory 
/dev/rdsk — e.g., /dev/rdsk/wd0s0. In addition to these regular device inter- 
faces, there is a diagnostic interface to the disk once the empt driver is 
present. This interface allows cmpt ioctls to be issued and also provides a 
read-only interface to the entire unpartitioned disk address space. The special 
file for the diagnostic interface has a major and minor device number equal to 
the unpartitioned device with 32768 added to the major number. By conven- 
tion, this special file is in the directory /deu/diag /rdsk— for example, 
/dev/diag /rdsk/sd0. 
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Note that when the cmpt driver is in place on a disk, the unpartitioned inter- 
face to the disk becomes unavailable, meaning that all attempts to open the 


unpartitioned disk fail with ENXIO. 


BINARY CONFIGURATION 


When building a kernel with the cmpt driver present, be sure that the binary 
configuration information in /etc/conf/uts/io/cmpt/cmpt_space.c is up to 
date. This includes partition tables for all of the disks which were supported 
under DYNIX V3.0. Other drives may be added to the configuration tables. 
The origin in sectors and size in sectors of the partitions on each drive are as 


follows: 
Vertex model 170 


Fujitsu model 2243AS 


Maxtor model XT1140 


partition 


NAH THhONH OS 


partition 


NOohoONH OS 


partition 


Noah WNr O 


start 


length 


15884 
33440 
117096 
15884 
51888 
0 
67772 
0 


length 


15884 
33440 
140436 
15884 
75228 
0 
91112 
0 


length 


15884 
33440 
233324 
15884 
168116 
0 
184000 
0 
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CDC Wren III 94161 


Micropolis 1375 


Fujitsu 22468a 


partition 


NAOoOhONEH OS 


partition 


NAAR ONH OS 


partition 


NOAoOhONH SO 


length 


15884 
33440 
284480 
15884 
219272 
0 
235156 
0 


length 


15884 
33440 
270270 
15884 
205062 
0 
220946 
0 
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CMPT(7) 
Fujitsu M2333K (swallow) 
partition 
0 
1 
2 
3 
4 
5 
6 
7 
Fujitsu M2351A (Eagle) 
partition 
0 
1 
2 
3 
4 
5 
6 
7 
Fujitsu M2344K (swallow 4) 
partition 
0 
1 
2 
3 
4 
5 
6 
7 


start 


221100 
237600 
660 
660 
271260 
660 
304920 
660 


start 


336720 
353280 
920 
920 
386400 
920 
420440 
920 


start 


502524 
520344 
1782 
1782 
554202 
1782 
588060 
1782 


length 


16500 

67320 

541200 
270600 
270600 
236940 
236940 
220440 


length 


16560 

67160 

771880 
385480 
385480 
352360 
352360 
335800 


length 


17820 
67716 
1106622 
552420 
554202 
518562 
520344 
500742 
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Fujitsu M2382K (swallow 5) 
partition start 


761076 
778572 
2187 
2187 
813564 
2187 
848556 
2187 


NHOTRWONH OS 


CDC 9715-340 (FSD) 
partition start 


238272 
255408 
816 
816 
289680 
816 
323136 
816 


Noah Onworo 


CDC 9771-800 (XMD) 
partition _ start 


644640 
660960 
1360 
1360 
696320 
1360 
728960 
1360 


Nooahwndr OS 
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length 


17496 
69984 
1622754 
811377 
811377 
776385 
776385 
758889 


length 


17136 

67728 

577728 
288864 
288864 
254592 
255408 
237456 


length 


16320 
68000 
1388560 
694960 
693600 
659600 
660960 
643280 


It is unwise to use two overlapping partitions simultaneously, since this can 


cause corruption of data. 


IOCTLS 
This driver supports the following commands to ioctl(): 
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V_BUILD 


This ioctl is used to build a cmpt device from an unpartitioned device. 
It should be passed to the device normally called /dev/empt and have, 
as the third argument to the system call, a pointer toa filled-out struct 
cmptdt. This structure is defined in /usr/include/sys/cmpt.h. The 
fields of struct cmptdt are cd_fd, an open file descriptor for a raw disk 
that does not have a partitioning driver in place; and cd_type, an inte- 
ger index into the table cmptparts defined in 

/etc/conf/uts/io/cmpt /cmpt_space.c. A possible coding example 


using this ioct] would be: 
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struct cmptdt cd; 


fd = open("/dev/cmpt", O_RDWR); 

fdl = open ("/dev/rdsk/zd1", O_RDWR); 
ed.cd_fd = fdl; 

cd.cd_type = 6; /* M2333K */ 
ioctl(fd, V_BUILD, &cd); 


This shows partitioning being added to disk type 6 (a Fujitsu "Swal- 
low" 3, model "M2333K"). If the ioctl is successful, the file descriptor 
in cd_fd should be treated as if it has already been closed and a subse- 
quent close() operation is not needed on this descriptor. This is nec- 
essary since a successful V_BUILD operation will make the unparti- 
tioned device inaccessible (i.e., /dev/rdsk/zd1 can no longer be 
opened if the V_BUILD operation above is successful). 


V_DESTROY 


The cmpt device in place on a disk is instructed to destroy all of the 
devices associated with partitions on this disk. The unpartitioned disk 
device is made available for use again. This ioct] will fail with EBUSY 
if any of the partitions which make up this disk are open, being used 
as a swap device, or has a mounted filesystem. The semantics of this 
joct] are identical to the V_BUILD ioctl, with the exception that the 
third argument to the ioctl call is the file descriptor returned from 
opening any valid partition on this disk or from opening the diagnostic 
device for this disk. 


V_WRITEPROTECT 


This ioctl] acts as a software write-protect switch. The first argument 
to the ioctl call should be an open file-descriptor to a raw partition. 
When V_WRITEPROTECT is run, all subsequent attempts to open for 
writing the character-special or block-special device for this partition 
will result in EBUSY being returned in errno. Note that the mount(2) 
system call performs the equivalent of a V_WRITEPROTECT ioctl to the 
mounted device. 


V_WRITEENABLE 


This ioct] reverses the effect of the V_WRITEPROTECT ioctl, allowing 
the partition’s character and block-special devices to be opened for 
writing. 


DEVTAB ENTRY 
In order for the empt driver to get established on disks automatically at sys- 


tem boot time, the file /dev/devtab must have lines added which direct the 
binding of the empt driver to disks. Lines for empt in /etc/devtab have the 
following form: 


cmpt special disktype 


where special is a character special file for an unpartitioned physical disk 
device, and disktype describes the type of disk. The valid disk type names are 
listed in the file /etc/devbuild.d/cmpt.types. If the empt driver becomes suc- 
cessfully established on the disk, special will become unavailable for use and 
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FILES 


the partitioned devices themselves become useable. 
For example, consider the following lines from /etc/devtab: 


cmpt /dev/rdsk/zdl m2333k 
cmpt /dev/rdsk/zd2 m2344k 
cmpt /dev/rdsk/sd0 wren3 


These lines will automatically build a cmpt driver on zd1, zd2, and sd0. The 
partitions for zd1 will be those for an m2333k (a Fujitsu "Swallow 3"); parti- 
tions for zd2 will be those for an m2344k (a Fujitsu "Swallow 4"); and parti- 
tions for sd0 will be those for a CDC Wren 3. 


/dev/cempt 

/dev/dsk/* 

/dev/rdsk/* 
/dev/diag/rdsk/* 
/etc/devtab 
/etc/devbuild.d/cmpt.types 


SEE ALSO 
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vtoc(7), devbuild(1a), devdestroy(1a), devtab(4) 


DYNIX/ptx CN(7) 


NAME 


cn — pseudoconsole driver 


CONFIGURATION ENTRY 


pseudodevice cn 


DESCRIPTION 


The purpose of the cn driver is to give users of the /dev/console device (e.g., 
daemons) a device which is immune to job control interference, and which 
tracks the selected console device on either SSM or SCED. 


Special Files 


This driver creates three special files: 


/dev/syscon tracks the console device which is selected at system boot time. 
It is used for single-user shells, and logins. Job control on this device does not 
affect processes that are writing to /dev/console. /dev/syscon supports job 
control. 


/dev/altcon is the "other" port on the SCED or SSM console port. Is useful for 
interactive purposes such as logins. /dev/altcon supports job control. 


/dev/console is meant to be used only by daemons and for logging text to the 
console device which was selected at system boot time. It tracks the console 
device, but does not allow processes opening it to become controlling processes. 
This way, these daemon processes don’t interfere with users of /dev/syscon 
who want to become controlling processes. /dev/console does not support job 
control. 


Usage 


Writes to /dev/console pass an extra flag to the stream code which forces it to 
not treat processes writing to /dev/console as background processes. Without 
this treatment, these processes could be stopped if they tried to write. Reads 
and IOCTLs to this special file are disallowed. They return with an EBADF 
error code. 


DIAGNOSTICS 


cn_init: invalid device init. An invalid device initialization was attempted 
in the cn driver. This indicates a kernel software bug. 
cn_init: real cn dev hasn’t been added. The cn driver initialization code 


failed because the real console driver hasn’t been established yet. This could 
be either a kernel software error or kernel configuration error. 


cen: problem adding syscons dev to devsw0 A problem occurred in trying 
to add the syscon tty device to the system. This is probably due to a driver 
which has added a device with the same major/minor number. 


SEE ALSO 
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NAME 
Go consmem, sm, 8s - console memory drivers 


CONFIGURATION ENTRY 
pseudodevice consmem 


DESCRIPTION 
consmem is a special file that is a pseudo driver that selects either the sm or 
ss console memory driver, depending on the location of the console. This 
allows system-independent code to be developed. Normally, all references to 
the console memory device should go through consmem. 


sm is a special file that is an image of the memory located on the SCED board, 
and ss is a special file that is an image of the memory located on the SSM 
board. They may be used, for example, to get system messages that are stored 
in battery-backed-up RAM. 

The layout of the address space depends on which console memory driver is 
actually in use by the system. 


Examining and patching device registers is likely to lead to unexpected results 
in both the sm and ss. 


Consmenm is a special device that always accesses the SCED or SSM board 
that is attached to the front panel and console. 


The following ioctl functions are provided: 


SMIOSTATS Get statistics about the use of the consmem, 
sm or ss driver 
@ SMIOGETREBOOTO Get the standard reboot structure 


SMIOSETREBOOTO Set the standard reboot structure 
SMIOGETREBOOT1 Get the dump reboot structure 
SMIOSETREBOOT1 Set the dump reboot structure 


SMIOGETLOG Get data regarding the system log 
SMIOSETLOG Set data regarding the system log (SCED only) 
SMIOSTATS uses the structure: 


struct consmem_stats { 

int consmem_cmd; /* number of commands */ 

int consmem_ioctls; /* number of ioctls */ 

int consmem_xfers; /* number of data transfers */ 
; 
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FILES 


SMIOGETREBOOT0, SMIOSETREBOOT0, SMIOGETREBOOT! and 
SMIOSETREBOOT! use the structure: & 


struct ioctl reboot { 
unsigned char re_powerup; /* reference powerup defaults */ 
unsigned int re_boot_flag; /* Boot flags */ 
unsigned char *re_ cfg addr; /* address to build config */ 
char re_boot_name [BNAMESIZE]; /* Boot image name */ 
i 
There are two boot names contained in the firmware. They are boot_name[0] 
and boot_name[1]. The SMIOGETREBOOT0 and SMIOSETREBOOTO get 
and set boot_name[0]. The SMIOGETREBOOT1 and SMIOSETREBOOT! get 
and set boot_name[1]. The value of the re_powerup flag must always be set 
to 0 before calling the kernel. For the SCED, there are also two re_cfg_addr 
values. SMIOGETREBOOT0 and SMIOSETREBOOTD access the first value 
and SMIOGETREBOOT!1 and SMIOSETREBOOT! access the second. The 
fields, boot_name[0] and boot_name[1] are stored in battery-backed-up RAM 
and exist across power cycles. If they are changed and the system rebooted 
the new names are used. 


SMIOGETLOG and SMIOSETLOG (SCED only) use the structure: 


struct cons_mem { 


char *mm_buffer; /* address of log buffer */ 

char *mm_nextchar; /* next free char in buffer */ 

short mm_size; /* buffer size */ @ 
short mm_nchar; /* number valid chars in buf */ 


A program can use this structure to determine the location and size of the log 
buffer and then use the read system call to get the actual data. 


/dev/consmem 
/dev/emem/sm* 
/dev/cmem/ss* 


SEE ALSO 


BUGS 


dmesg(1M), savecore(1M), bootflage(1M) 


The sm driver reads values as bytes; this may not be appropriate for some 
16-bit device registers on the board. 
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NAME 


console — console interface 


© DESCRIPTION 


The Sequent console interface provides access to the system console through a 
Sequent SCSI/Ethernet/Diagnostics (SCED) Board or Sequent System Ser- 
vices Module (SSM), depending on which board has taken control of the sys- 
tem during boot. (If an SSM is present in a system, it will provide the console 
interface, even though a SCED board may also be present in the system. Ifno 
SSM is present, the SCED board will provide the console interface.) 


The co driver provides the SCED console interface functionality. Similarly, 
the sc driver provides the SSM console interface functionality. 


When the operating system is running, the console interface behaves like a 
normal terminal; see streamtty(7). Two terminal lines are available per 
SCED or SSM. All standard baud rates are supported on each of these lines. 
The hardware signals DTR and RTS are enabled on open of the lines and dis- 
abled on close if HUPCL is specified. These signals may be changed via ioctl 
calls to the device driver and are used when flow control is enabled. Break 
character detection and generation is also supported. 


Selection of the system console and the alternate console are determined at 
boot time by the monitor firmware based on the LOCAL and REMOTE front 
panel switch. The system console is the selected port and the alternate con- 
sole is the unselected port. Device special files named /dev/console and 
/dev/syscon will track the system console port. The special file named 
/dev/altcon represents the alternate console port. /dev/console is a write- 
only device that can be used to log output from background daemons to the 
system console device with no consequence of becoming the controlling tty. 
/etc/getty processes should be put on /dev/syscon and /dev/altcon for system 
login purposes but will fail when put on /dev/console. 


If the SCED monitor firmware flags specify that break characters cause a 
return to monitor firmware, a break on a SCED console line will cause an 
immediate return to firmware. On all other SCED console lines and all SSM 
console lines, the break character is interpreted according to streamtty(7). 


Other than these exceptions, the system console and the alternate console 
work like any other terminal line. 


Minor Numbers 
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Minor numbers for device nodes corresponding to console lines are selected as 
follows: 


SCED Device Minor Number _ Location 
/dev/ttyBA/BAAA 0 SCED Board 0, local port 

| dev /ttyBA/BAAB 1 SCED Board 0, remote port 
/ dev /ttyBA/BAAC 2 SCED Board 1, local port 
/dev/ttyBA/BAAD 3 SCED Board 1, remote port 
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FILES 


/dev/ttyBA/BAAE 
/dev/ttyBA/BAAF 
/dev/ttyBA/BAAG 
/dev/ttyBA/BAAH 


SSM Device 


/dev /ttyWA/WAAA 
/dev/ttyWA/WAAB 
/ dev /ttyWA/WAAC 
/dev/ttyWA/WAAD 
/dev/ttyWA/WAAE 
/dev/ttyWA/WAAF 
/dev/ttyWA/WAAG 
/dev/ttyWA/WAAH 


/dev/console 

/dev/syscon 

/dev/altcon 
/dev/ttyBA/BAA[A-H] 
/devittyWA/WAA[A-H] 
/ete/conf/uts/io/co/co_space.c 
/etc/conf/uts/io/sc/sc_space.c 


SEE ALSO 


streamtty(7), cn(7) 


NOTA 


Number 


NATL ONEH OS 
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SCED Board 2, local port 
SCED Board 2, remote port 
SCED Board 3, local port 
SCED Board 3, remote port 


Location 


SSM Board 0, local port 
SSM Board 0, remote port 
SSM Board 1, local port 
SSM Board 1, remote port 
SSM Board 2, local port 
SSM Board 2, remote port 
SSM Board 8, local port 
SSM Board 3, remote port 
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NAME 
@ kMBmem, kMWmem — MULTIBUS memory 
CONFIGURATION ENTRY 
pseudodevice kmmem 
DESCRIPTION 


The files /dev/cmem/kMBmem and /dev/cmem/kMWmem represent MUL- 
TIBUS address space, consecutively mapped 1 megabyte per MULTIBUS con- 
troller, starting at 0 for the first controller. (Deconfigured controllers still 
reserve their own address space.) Accesses via /dev/cmem/kMBmem are one 
byte at a time, while accesses via /dev/cmem/kMWmem are two bytes at a 
time (one 16-bit word). 


A mapping request with mmap(2seq) cannot cross an MBAd boundary, and 
must be made to an existing MBAd. There is no checking to prevent a map- 
ping request from referencing non-existent MBAd address space. These 
devices map as physical maps (MM_PHYS). 

FILES 
/dev/cmem/kKMBmem 
/dev/cmem/kMWmem 

SEE ALSO 
mmap(2seq) 
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NAME 
& 1d0 — STREAMS tty line discipline 
DESCRIPTION - 
1d0 is a STREAMS module that implements most of the terminal interface 
described in termio(7). It relies on the downstream driver supporting the 
generic STREAMS tty driver interface described in streamtty(7). 


Read-side Received Messages 
M_CTL The first data byte of the control message indicates the type of 
operation. Additional data bytes may be supplied dependent on 
the operation. Supported operations are: 


MC_FRAME_ERR A framing error was detected. If the data 
value of the character with the framing error 
is known, it is provided in the remaining data 
bytes of the message. If not supplied, the data 
value of the character is assumed to be zero. 

A framing error character whose data value is 
zero is interpreted as a break condition. If 
CREAD (c_cflag ) is not set, the message is dis- 
carded. Otherwise the message is entirely 
processed within this module. In either case 
the message is not passed upstream. 


MC_PARITY_ERR 
A parity error was detected. If the data value 
of the character with the parity error is 
known, it is provided in the remaining data 
bytes of the message. If not supplied, the data 
value of the character is assumed to be zero. 
If CREAD (c_cflag ) is not set, the message is 
discarded. Otherwise the message is entirely 
processed within this module. In either case 
the message is not passed upstream. If INPCK 
(c_iflag ) is set, the data in the message is pro- 
cessed as a character with a parity error; 
otherwise the message is treated as an 
M_DATA message (that is, as a character with- 
out a parity error). 
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M_PCCTL 


M_DATA 


M_FLUSH 


M_IOCACK 


M_IOCNAK 
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The first data byte of the control message indicates the type of 
operation. Additional data bytes may be supplied dependent on 
the operation. Supported operations are: 


MC_STOPI The driver is requesting that all input data 
messages stop if IXOFF is set. Typically a 
MC_STOPI message is sent back to the driver. 


If CREAD (c_cflag ) is set, several kinds of input processing are 
done according to termio(7); these are briefly described below. 
If CREAD is not set, the message is discarded. 


If ISIG is set, INTR, QUIT, and SUSP characters are immediately 
detected and result in an M_PCSIG message sent upstream corre- 
sponding to the appropriate signal. 


If IXON is set, M_PCCTL messages requesting the MC_START and 
MC_STOP functions (see TCXONC below) are sent downstream in 
immediate response to the START and STOP characters, respec- 
tively. If IXANY is also set, any character can function asa 
START character. 


In canonical mode (ICANNON is set), received data is assembled 
into lines with erase, kill, and other processing as described in 
termio(7). The buffer used for line assembly can contain at 
least a maximum of MAX_CANON characters; if it overflows, all 
characters in it are silently thrown away. 


In non-canonical mode, received data is not internally retained 
or delayed for line assembly but is rather immediately passed 
upstream. The semantics of MIN and TIME (as described in ter- 
mio(7)) are implemented at the stream head. 


If FLUSHR or FLUSHRW is specified, the read queue is flushed 
along with all the data collected in the current line and the mes- 
sage is passed upstream. 

The message data is augmented (in the case of TCGETA and 
TCGETP) and the message is passed upstream. If the ioc_id 
matches that saved on an incoming TIOCGETP, it is converted to 
a struct sgttyb before being sent upstream as a TIOCGETP. 


If the message is for a TIOCGWINSZ or TIOCSWINSZ ioctl(2) call, 
the M_IOCNAK is intercepted and the ioctl is performed as 
described in the IOCTLS sections below. 


All other messages are passed upstream unchanged. 


Write-side Received Messages 


M_DATA 


M_FLUSH 


If OPOST is set, or if ICANON, XCASE, and IEXTEN are set, appro- 
priate output processing is performed on the data and the result 
is passed downstream, possibly augmented with M_LDELAY mes- 
sages. Otherwise, the data is passed downstream unchanged. 
If FLUSHW or FLUSHRW is specified, the write queue is flushed 
and the message is passed downstream. 
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M_IOCTL 

M_PCIOCTL The ioctl(2) calls described in termio(7) that are supported by 
1d0 are described in the IOCTLS section below. Note that the 
TIOCGWINSZ and TIOCSWINSZ ioctl calls are not recognized at 
this point, but later if an M_LIOCNAK message is received on the 
read-side. 


M_IOCDATA Recognized if it applies to a TRANSPARENT ioctl being currently 
performed. 


All other messages are passed downstream unchanged. 


Additional Read-side Processing 


When the 1d0 put procedure determines that flow control is trying to prevent 
additional messages to 1d0 (via canput()), the message is enqueued and, if 
IXOFF (c_iflag ) is set, a request is sent to the device driver to suspend addi- 
tional input. This request is an M_PCCTL message sent downstream whose 
first data byte is MC_STOPI and remaining data bytes contain the current 
STOP character. When the service procedure determines that flow control is 
allowing additional messages to 1d0 and IXOFF processing currently has input 
suspended, a request is sent to the device driver to resume suspended input. 
This request is an M_PCCTL message sent downstream whose first data byte is 
MC_STARTI and remaining data bytes contain the current START character. 


IOCTLS 
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TCGETA 

TCGETP 

TIOCGETP M_PCIOCTL message passed downstream during write-side pro- 
cessing. If a positive acknowledgment is seen, the parameter 
information provided by the driver and downstream modules is 
augmented and passed upstream. 


In the case of TIOCGETP the incoming struct sgttyb is con- 
verted into a termios structure and the ioctl] message type is 
changed to TCGETP and the io_id is saved. When the 
M_IOCACK is returned, it is converted back to its original form. 


TIOCGWINSZ M_IOCNAK message received during read-side processing. The 
negative acknowledgement is intercepted and the ioctl opera- 
tion is performed. If the message is for a TRANSPARENT ioctl, 
an M_COPYOUT message is sent upstream containing a struct 
winsize with the current setting of the window size of the ter- 
minal. If the message is not a TRANSPARENT ioctl, the struct 
winsize is sent up in an M_LIOCACK message. 


TIOCSETP Recognized during write-side processing. The function is par- 
tially performed by 1d0 and the message is passed downstream. 
In the case of TCSETP and TCSETA the message is an 
M_PCIOCTL otherwise the message is an M_IOCTL. 
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The parameters relevant to 1d0 operation are internally 
updated and the message is passed downstream unmodified. If 
a parameter change requires options at the stream head to 
change, an M_PCSETOPT message is sent upstream. If [CANON 
is set, the stream head is placed in message non-discard mode 
and the MIN and TIME stream head options are set to 1 and 
zero, respectively. If ICANON is not set, the stream head is 
placed in byte-stream mode and the MIN and TIME stream head 
options are set from the values in the ioctl. In either case, if 
TOSTOP (c_Iflag ) is changed in the ioctl, the stream head 
option is set based on the value in the ioctl. 


All c_cflag fields except CREAD are not implemented by 1d0 and 
hence must be supported by lower-level modules in order to 
fully implement the termio(7) interface. 


Other parameters, while implemented by 1d0, may also be 
interpreted by lower-level modules in an effort to provide more 
intelligent or timely behavior as long as this behavior adheres 
to the termio(7) interface. For example: If IXON (c_iflag) is 
set, lower modules could do output flow control (e.g., in hard- 
ware) using the START and STOP characters defined in the c_ec 
array rather than relying on 1d0 to send M_PCCTL messages 
requesting the MC_START and MC_STOP functions downstream 
(see TCXONC below) in response to the START and STOP charac- 
ters; IXANY (c_iflag ) could be similarly handled. If CREAD 
(c_cflag ) is not set, the terminal receiver hardware could be 
disabled rather than relying on 1d0 to silently discard input in 
this case. 


In the case of TIOCSETP, the incoming struct sgttyb is con- 
verted into a termios structure and its type changed to 
TCSETP. When the M_IOCACK is returned it is converted back 
to its original form. 


M_PCIOCTL message recognized during write-side processing. 
The function is entirely performed by 1d0; the reply is sent 
upstream and no message is passed downstream. 


If the argument is zero, an M_PCCTL message is sent down- 
stream whose first data byte is MC_STOP. If the argument is 1, 
an M_PCCTL message is sent downstream whose first data byte 
is MC_START. If the argument is 2, an M_PCCTL message is 
sent downstream whose first data byte is MC_STOPI and 
remaining data bytes contain the current STOP character. If 
the argument is 3, an M_PCCTL message is sent downstream 
whose first data byte is MC_STARTI and remaining data bytes 
contain the current START character. 


M_PCIOCTL message recognized during write-side processing. 
The function is entirely performed by 1d0; the reply is sent 
upstream and no message is passed downstream. 


If the argument is zero, an M_FLUSH message is sent down- 
stream whose first data byte is FLUSHR. If the argument is 1, 
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TIOCSWINSZ 


WARNINGS 
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an M_FLUSH message is sent upstream whose first data byte is 
FLUSHW. If the argument is 2, an M_FLUSH message is sent 
downstream whose first data byte is FLUSHR and an M_FLUSH 
message is sent upstream whose first data byte is 


Whenever read-side flushing is requested, the M_IOCACK is 
delayed until after the read side has processed the M_FLUSH 
such that the flush is synchronous with respect to subsequent 
(but not concurrent) data reads. 


M_IOCNAK message received during read-side processing. The 
negative acknowledgement is intercepted and the TRANSPAR- 
ENT ioctl operation is performed. An M_COPYIN message is 
sent upstream requesting the struct winsize with the new set- 
tings for the window size of the terminal. When the subse- 
quent M_IOCDATA message is received, the terminal window 
size parameters are adjusted accordingly. If any of the current 
settings are changed, an M_SIG message is sent upstream caus- 
ing the SIGWINCH signal to be generated. 


The following termio(7) functionality is not implemented by 1d0 or the termi- 
nal driver and needs to be implemented at or above the stream head. 


Support in read(2), write(2), ioctl(2), and fentl(2) for: Terminal Access Con- 
trol functions associated with job control (foreground process group checks 
including TOSTOP), MIN and TIME semantics in non-canonical mode, and 
O_NONBLOCK and O_NDELAY semantics. The TIOCGPGRP and TIOCSPGRP 
ioctls in their entirety. Modem Disconnect semantics triggered on receipt of 
an M_HANGUP message. 


FILES 
/dev/tty* 


SEE ALSO 


stty(1), fork(2), ioctl(2), setpgrp(2), signal(2), streamtty(7), termio(7) 
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NAME 


log — interface to STREAMS error logging and event tracing 


@ CONFIGURATION ENTRY 


pseudodevice log number 


DESCRIPTION 


log is a STREAMS software device driver that provides an interface for the 
STREAMS error logging and event tracing processes (strerr(1M), strace(1M)). 
log presents two separate interfaces: a function call interface in the kernel 
through which STREAMS drivers and modules submit log messages; and a 
subset of ioctl(2) system calls and STREAMS messages for interaction with a 
user-level error logger, a trace logger, or processes that need to submit their 
own log messages. The driver supports number minor devices, which limits 
the number of user processes that can simultaneously be submitting log mes- 
sages. (Note that two of those devices will be used by the error logger and 
trace logger if those processes are running.) 


Kernel Interface 


log messages are generated within the kernel by calls to the function strlog: 


strlog(mid, sid, level, flags, fmt, arg, ...) 
short mid, sid; 
char level; 
ushort flags; 
char *fmt; 
unsigned arg]; 
Required definitions are contained in <sys/strlog.h> and <sys/log.h>. 


mid The STREAMS module ID number for the module or driver submitting 
the log message. 


sid An internal sub-ID number usually used to identify a particular minor 
device of a driver. 


level A tracing level that allows for selective screening out of low-priority 
messages from the tracer. 


flags Any combination of SL_ERROR (the message is for the error logger), 
SL_TRACE (the message is for the tracer), SL_FATAL (advisory notifica- 
tion of a fatal error), and SL_NOTIFY (request that a copy of the mes- 
sage be mailed to the system administrator). 


fmt A print£(3S) style format string, except that %s, %e, %E, %g, and %G 
conversion specifications are not handled. Up to NLOGARGS (cur- 
rently 3) numeric or character arguments can be provided. 


User Interface 
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log is opened via the clone interface, /dev/log. Each open of /dev/log 
obtains a separate stream to log. In order to recieve log messages, a process 
must first notify log whether it is an error logger or trace logger via a 
STREAMS L_STR ioctl call (see below). For the error logger, the I_STR ioctl has 
an ic_emd field of LERRLOG, with no accompanying data. For the trace 
logger, the ioctl has an ic_emd field of I TRCLOG, and must be accompanied 
by a data buffer containing an array of one or more struct trace_ids ele- 
ments. Each trace_ids structure specifies an mid, sid, and level from which 
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message will be accepted. strlog will accept messages whose mid and sid 
exactly match those in the trace_ids structure, and whose level is less than 
or equal to the level given in the trace_ids structure. A value of -1 in any of 
the fields of the trace_ids structure indicates that any value is accepted for 
that field. 


At most one trace logger and one error logger can be active at a time. Once 
the logger process has identified itself via the ioctl call, log will begin sending 
up messages subject to the restrictions noted above. These messages are 
obtained via the getmsg(2) system call. The control part of this message con- 
tains a log_ctl structure, which specifies the mid, sid, level, flags, time in ticks 
since boot that the message was submitted, the corresponding time in seconds 
since Jan. 1, 1970, and a sequence number. The time in seconds since 1970 is 
provided so that the date and time of the message can be easily computed, and 
the time in ticks since boot is provided so that the relative timing of log mes- 
sages can be determined. 


Different sequence numbers are maintained for the error and trace logging 
streams, and are provided so that gaps in the sequence of messages can be 
determined (during times of high message traffic some messages may not be 
delivered by the logger to avoid hogging system resources). The data part of 
the message contains the unexpanded text of the format string (null ter- 
minated), followed by NLOGARGS words for the arguments to the format 
string, aligned on the first word boundary following the format string. 


A process may also send a message of the same structure to log, even if it is 
not an error or trace logger. The only fields of the log_ctl structure in the 
control part of the message that are accepted are the level and flags fields; all 
other fields are filled in by log before being forwarded to the appropriate 
logger. The data portion must contain a null terminated format string, and 
any arguments (up to NLOGARGS) must be packed one word each, on the next 
word boundary following the end of the format string. 


Attempting to issue an I_TRCLOG or I_ERRLOG when a logging process of the 
given type already exists will result in the error ENXIO being returned. Simi- 
larly, ENXIO is returned for I_.TRCLOG ioctls without any trace_ids structures, 
or for any unrecognized I_STR ioctl calls. Incorrectly formatted log messages 
sent to the driver by a user process are silently ignored (no error results). 


EXAMPLES 
Example of LERRLOG notification. 
struct strioctl ioc; 


ioc.ic_cmd = I_ERRLOG; 

jdoc.ic_timout = 0; /* default timeout (15 secs.) */ 
loc.ic_len = 0; 

loc.ic_dp = NULL; 


ioct1(log, I_STR, &ioc); 


Example of I_LTRCLOG notification. 
struct trace_ids tid[2]; 


tid[0].ti_mid = 2; 
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tid[0).ti_sid = 0; 

tid[0].ti_level = 1; 

tid[1].ti_mid = 1002; 

tid(1].ti_sid = -1; /* any sub-ID will be allowed */ 
tid[1].ti_level = -1; /* any level will be allowed */ 


loc.ic_cmd = I_TRCLOG; 

loc.ic_timout = 0; 

loc.ic_len = 2 * sizeof (struct trace_ids); 
joc.ic_dp = (char *)tid; 


doctl(log, I_STR, &ioc); 
Example of submitting a log message (no arguments). 
struct strbuf ctl, dat; 


struct log ctl lc; 
char *message = "Don’t forget to pick up some milk"; 


ctl.len = ctl.maxlen = sizeof (lc); 
ctl.buf = (char *)&lc; 


dat.len = dat.maxlen = strlen(message) ; 
dat.buf = message; 


lec.level = 0; 


@ lc.flags = SL_ERROR|SL_NOTIFY; 


putmsg(log, &ctl, &dat, 0); 


FILES 
/devlog 
<sys/log.h> 
<sys/strlog.h> 


SEE ALSO 
clone(7), getmsg(2), intro(2), putmsg(2), strace(1M), strerr(1M) 
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NAME 


lp — Systech parallel line printer interface 


CONFIGURATION ENTRY 


Ip on multibus multibus unit unit segsize 1024nsegs 4 


DESCRIPTION 


The Ip device driver supports the Systech MLP-2000 controller for line print- 
ers using the Centronics or Dataproducts parallel interfaces. It supports up to 
two line printers per controller. The standard controller names consist of Ip 
followed by the controller unit number (e.g., Ip0, Ip1), which specifies the 
hardware configuration of the printer. 


The controller board, on MULTIBUS multibus, is configuration unit number 
unit. The configuration unit number is an index into the lp_multibus_config 
table in the file /etc/conf/uts/io/lp/Ip_space.c and must be unique with 
respect to other Ip devices on this MULTIBUS. Both the multibus and unit 
may be specified with a "?,” meaning they are wild-carded. If multibus is wild- 
carded, the system assigns the number of the MULTIBUS in which the board 
is physically located. If unit is wild-carded, the system assigns the configura- 
tion unit number of the first unused matching entry in the [p_multibus_config 
table. A board matches if it is at the address specified in the Jp_multibus_con- 
fig table entry. The interrupt vector cannot be checked, so care must be taken 
to ensure that the interrupt vector is jumpered to match the lp_multibus_con- 
fig table entry. The segsize field is the size of address space reserved for DMA 
transfers and must be 1024. The nsegs field indicates how many regions to 
reserve for DMA transfers for this device and must be 4. 


The minor device number addresses a specific printer by controller and port 
number. Minor numbers 0 and 1 indicate ports 0 and 1, respectively, on the 
first controller in the system configuration file, minor numbers 2 and 3 indi- 
cate ports 0 and 1, respectively, on the second controller in the system confi- 
guration file, and so forth. The standard device names consist of Ip followed 
by the minor device number (e.g., Ip0, Ip1). Each device is exclusive access on 
open. 

Each controller occupies 32 contiguous bytes of MULTIBUS I/O address space 
starting at the csr address. 


BINARY CONFIGURATION 
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The printer can be configured for one of three different modes which are 
described in lpmod(7). The different modes are implemented by Ipmod, a 
STREAMS modules pushed onto the driver automatically when the device is 
opened. If the system is configured to not have this module pushed, the 
printer will always be in raw mode regardless of what is in the lp_config table. 
The table controlling the push for this module is in /etc/conf/uts /ker- 

nel /i386_space /autop_space.c. 

Raw mode provides an eight-bit data path to the printer. Tabs, formfeeds, 
newlines and other special characters are not expanded, and no line or page 
adjustments are made. 


To see a description of the other modes, refer to the man page for Ipmod. 


The configuration options are specified in a table in the binary configuration 
file, /ete/conf/uts/io/lp /Ip_space.c. The first column specifies the line 
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length. The second column specifies the number of lines per page. The third 
column specifies the mode. Note that all of these fields are ignored by the 
driver and are only there for the benefit of modules which may be pushed onto 
the driver. The printer characteristics are indexed by the minor number of 
the device. If the minor number is greater than the number of entries in the 
array, the configuration options for the last entry in the table are used. For 
example, if you had the following hardware configuration: 


printer 0 80 columns 25 lines upper case only 

printer 1 132 columns 25 lines raw 

printer 2 132 columns 96 lines raw 

printer 3 80 columns 66 lines raw 

printer 4 132 columns 66 lines special processing 
5 


printer 132 columns 66 lines special processing 
you could use the following configuration table: 


structlp printer I1pconfig[] = { 


/* cols, ht, special _ map 
*/ 

{ 80, 25, PRCAPS ), /* 0 */ 
{ 132, 25, PRRAW }, /* 1 */ 
{ 132, 96, PRRAW de /* 2 ¥f 
{ 80, 66, PRRAW d. /* 3 */ 
{ 132, 66, PRSPECIAL ), /* 4 */ 
}; 


Note that the sixth printer (number 5) is not specified in the configuration but 
will have the same characteristics as printer number 4. 


The default configuration is as follows: 


structlp printer I1pconfig[] = { 


/* cols, ht, special_map 
a 
{ 132, 66, PRRAW } , L® 101 7 
{ 132, 66, PRRAW } , /® a, 8/ 
e 
Buffer Size 


FILES 


The number of maps specified in the entry for the controller in 
/etc/conf/io/lp_space.c determines the size of the data buffer. The maximum 
buffer size per printer is 8K bytes. Each printer is allocated half the number 
of maps specified for its controller (since each controller supports up to two 
printers). Each map results in 1K bytes of buffering. : 


/dev/printer/|p* 
/etc/conf/utsio/lp/lp_space.c 


SEE ALSO 


1p(1), lpmod(7), lpstat(1), pr(1), lpadmin(1M), terminfo(4) 
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NAME 


Ipmod — parallel printer canonical processing module 


DESCRIPTION - 


Ipmod is a STREAMS module that provides special character processing for 
parallel printers. It supports three modes of processing, raw mode, special 
processing mode, and uppercase-only mode. Ipmod requests configuration 
information from the driver in order to determine which mode to use. It 
expects to get a line length value as well as the mode from the driver. If the 
driver does not support the request message, Jpmod uses default values: 132 
for the line length and PRRAW (raw mode) for the mode. 


PRRAW mode 

Raw mode provides an eight-bit data path to the printer. Tabs, formfeeds, 
newlines and other special characters are not expanded, and no line or page 
adjustments are made. Raw mode is essentially the same as not having 
Ipmod pushed on the stream; it passes data to the driver unchanged. 


PRSPECIAL mode 

In special processing mode, lpmod interprets newlines, backspaces, tabs, and 
form feeds. Tab stops are every 8 columns starting at column 8 (i.e., 8, 16, 
24...). Most printers can operate in both print and plot modes using the spe- 
cial processing mode. In addition, lpmod outputs a formfeed on close, and 
truncates lines longer than the length specified in the printer configuration 
table. Lines longer than the maximum line length are silently truncated. 


PRCAPS mode 
In uppercase-only mode, Ipmod performs all the functions specified above for 
special processing mode, and in addition does some character mapping. In 
particular, lower case letters are mapped into upper case. Other characters 
are mapped to similar characters overstruck with “-” according to the follow- 
ing table: 

Input Mapped to 


{ ¢ 
} ) 


CONFIGURATION 
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The system can be configured to push Ipmod automatically onto a driver 
when a device is opened. The table enabling this is in /ete/conf/uts/ker- 
nel /i386_space /autop_space.c. 

Alternatively, a user process opening a device can push Ipmod using the 
STREAMS push mechanism. 

See individual driver man pages to determine how to set the mode and line 
length values for a specific device. 
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FILES 
/dev/printer/* 
/ete/conf/uts/kernel/i386_space/autop_space.c 


SEE ALSO 
Ip(7), terminfo(4) 


2 12/89 


DYNIX/ptx MBAD(7) 


NAME 


mbad — MULTIBUS adapter 


CONFIGURATION ENTRY 


mbad interface on sb8000 unit ? 
multibus busno on mbad interface unit ? 


DESCRIPTION 


The MULTIBUS adapter (mbad) is a Sequent computer system board which 
provides a MULTIBUS interface for the Sequent computer. The mbad num- 
ber is specified by interface in the configuration entry. The MULTIBUS num- 
ber, busno, and the mbad interface number, interface, must be assigned in 
sequential order starting at zero. The unit number, unit , must be specified 
with "2" in both of the configuration entries shown above. The "?" is a wild- 
card that allows the autoconfiguration subsystem to assign correct unit num- 
bers. 


The MULTIBUS devices supported are the Ip(7), Systech parallel line printer 
interface, st(7), Systech MTI-800/1600/1650 terminal multiplexor driver, and 
xt(7), Xylogics 472 MULTIBUS magtape interface. 


SEE ALSO 
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1p(7), st(7), xt(7) 
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NAME 


mem, kmem — core memory 


CONFIGURATION ENTRY 


pseudodevice mem 


DESCRIPTION 


FILES 


The file /dev/mem is a special file that is an image of the core memory of the 
computer. It may be used, for example, to examine, and even to patch the sys- 
tem. 

Byte addresses in /dev/mem are interpreted as memory addresses. Refer- 
ences to non-existent locations cause errors to be returned. 

Examining and patching device registers is likely to lead to unexpected results 
when read-only or write-only bits are present. 

The file /dev/kmem is the same as /dev/mem except that kernel virtual 
memory rather than physical memory is accessed. 


/dev/mem 
/dev/kmem 


WARNINGS 
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Some of /dev/kmem cannot be read because of write-only addresses or une- 
quipped memory addresses. 
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NAME 


mtio — UNIX magnetic tape interface 


=) DESCRIPTION - 
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Operating system magtape device names adhere to this naming convention: 
/ dev | {r}mt | <driver-name><unit><format>{n} 


<driver-name> is either ts for SCED-based SCSI tape devices, tm for SSM- 
based SCSI tape devices, tg for SSM-based SCSI GCR tape devices or xt for 
MULTIBUS-based GCR tape devices. <unit> is a decimal number which cor- 
responds to the specific tape drive. The value of <format> is defined for 1/2" 
GCR tape drives only. <format> may be h, m or I for tape densities of 6250, 
1600 or 800 bpi, respectively. If density is not specified, the density currently 
set and showing on the tape drive’s front panel is used. Finally, the suffix n 
added to the end of the device name indicates that the driver will not rewind 
the tape on close. 


When a file open for writing is closed, two end-of-files are written. If the tape 
is not to be rewound, it is positioned with the head between the two tape- 
marks. If the most recent tape operation in not a valid tape ioctl, the tape is 
left at its current location. 


A standard tape consists of a series of 1024-byte records terminated by an 
end-of-file. To the extent possible, the system makes it possible, if inefficient, 
to treat the tape like any other file. Seeks have their usual meaning and it is 
possible to read or write a byte at a time. Writing in very small units is inad- 
visable, however, because it tends to create very large record gaps. 


When foreign tapes are to be dealt with, and especially when long records are 
to be read or written, the ‘raw’ interface is appropriate. The associated files 
are named /dev/rmt /<driver-name><unit><format>(n} but the same minor- 
device considerations as for the regular files still apply. A number of other 
ioctl operations are available on raw magnetic tape. Not all operations are 
supported by each driver. The following definitions are from <sys/mtio.h>: 


/* 
* Structures and definitions for mag tape io control commands 
s/f 


/* 
/* structure for MTIOCTOP - */ mag tape op command */ 
*/ 
struct mtop { 
short mt_op; /* operations defined below */ 
daddr_t mt_count; /* how many of them */ 
/* 
/* operations */ 
a7 
$define MTWEOF 0 /* write an end-of-file record */ 
fdefine MTFSF 1 /* forward space file */ 
$define MTBSF 2 /* backward space file */ 
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forward space record */ 

backward space record */ 

rewind */ 

rewind and put the drive offline */ 

no operation, sets status only */ 
erase from current position to EOT */ 
retension the (streamer) tape */ 

skip to end of (streamer) tape data */ 
don’t retention the tape this time */ 


/* structure for MTIOCGET - mag tape get status comman 


type of magtape device */ 


/* the following two registers are device dependent */ 


‘*drive status’’ register */ 
‘*error’’ register */ 


#define MIFSR 3 /* 
f#define MTBSR 4 /* 
fdefine MTREW 5 7 has 
$define MIOFFL 6 L* 
f#define MTNOP 7 /* 
fdefine MTERASE 8 hg 
$define MTRET 9 £® 
fdefine MTSEOD 10 /* 
fdefine MINORET 11 /* 
/* 
*/ 
struct mtget { 
short mt_type; /* 
short mt_dsreg; /* 
short mt_erreg; /* 
/* end device-dependent registers */ 
short mt_resid; /* 


residual count */ 


/* the following two are not yet implemented */ 
daddr_t mt_fileno; 
daddr_t mt_blkno; 

/* end not yet implemented */ 


/* 


/* 
/* 


file number of current position */ 
block number of current position */ 


* Constants for mt_type byte 


*/ 
fdefine 
fdefine 
fdefine 
§define 
Sdefine 
Sdefine 
#define 
Sdefine 
fdefine 
f#define 


/* 


MT_ISTS 
MT_ISHT 
MT_ISTM 
MT_ISMT 
MT_ISUT 
MT_ISCPC 
MT_ISAR 
MT_ISXT 
MT_ISST 
MT_ISTB 


0x01 
0x02 
0x03 
0x04 
0x05 


0x06 


0x07 
0x08 
0x09 
Ox0A 


/* mag tape io control commands */ 


/ 
$define 
fdefine 


MTIOCTOP _IOW(m, 1, struct mtop) /* do a mag tape op */ rT 
MTIOCGET _IOR(m, 2, struct mtget) /* get tape status */ 


Each read or write call reads or writes the next record on the tape. In the 
write case the record has the same length as the buffer given. During a read, 
the record size is passed back as the number of bytes read, provided it is no 
greater than the buffer size; if the record is long, an error is indicated. In raw 
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tape I/O seeks are ignored. A zero byte count is returned when a tape mark is 
read, but another read will fetch the first record of the new tape file. 


FILES ; 
/dev/mt/* and /dev/Armt/* 


SEE ALSO 
mt(1), tar(1), ta(7), tm(7), tg(7), xt(7) 


BUGS 
The status should be returned in a device independent format. 


The auto density-select functionality for 1/2" gcr-type tape drives is not imple- 
mented in some drivers. 
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NAME 


* null — the null file 
DESCRIPTION - 


Data written on the null special file, /dev/null, is discarded. 
Reads from a null special file always return 0 bytes. 


FILES 
/dev/null 
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NAME 


pmap — map physical addresses into process’s virtual address space 


CONFIGURATION ENTRY 


pseudodevice pmap number 


DESCRIPTION 


The pmap device driver is used in conjunction with the mmap(2seq) system 
call to map arbitrary physical addresses into a process’s virtual address space. 
The driver supports number minor devices, each of which may represent a 
specified region of the physical address space. The region associated with each 
device may be defined at kernel build time in the file 
/etc/conf/uts/io/pmap/pmap_space.c, and can be altered at run time by the 
superuser via the pmap() utility or the ioctls described in this manual entry. 
The pmap driver can support both physical devices (such as MULTIBUS 


address space) and non-paged memory devices (such as special areas of mem- 
ory reserved for accelerators). 


In /etc/conf/uts/io/pmap/pmap_space.c, the boot-time parameters of the 
minor devices are defined as an array of struct pmap_unit, which is defined 
as follows: 


struct pmap_unit { 


u_long pm_paddr; /* start physical (byte) address */ 
u_long pm_size; /* size (in physical pages) */ 

u_char pm_flags; /* flags (see below) */ 

<other fields> /* not user visible, initially zero */ 


Me 

The pm_padadr field must be a multiple of the system page size (see get- 
pagesize(2seq)), and the pm_size field must be a multiple of (system page 
sizeV(hardware page size). The hardware page size is defined as NBPG in 
/usr/include/sys/mc_param.h. There are three flags: 


#define PMAP_EXCL 0x01 /* exclusive access */ 
#define PMAP_MAPPED 0x02 /* is currently mapped */ 
#define PMAP_NPMEM 0x04 /* non-paged memory, else physical */ 


The PMAP_EXCL and PMAP_MAPPED flags should not be set in 
/ete/conf/uts/io/pmap/pmap_space.c. PMAP_NPMEM should be set if the 
associated device is of the non-paged memory variety. However, these 
requirements are not checked. 


There is no read or write system call interface to this driver. 


IOCTLS 
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The pmap driver supports the following ioctls. Some ioctls use the following 
structure, which is defined in /usr/include/sys/pmap.h: 
structpmap_ioc { 
u_long pi_paddr; /* start physical (byte) address */ 
u_long pi_size; /* size (bytes) */ 
u_char pi_flags; /* flags (see above) */ 
Ye 
Note that in the pmap_ioc structure, the size is specified in bytes, while in 
the pmap_unit structure it is specified in hardware pages. 
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ioctl(fd, PMAPIOCGETP, pmap_data) 
int fd; 
structpmap_ ioc *pmap data; 


Returns the current parameters from the pmap_unit table for the open unit 
referenced by fd. Any process can execute this call. EFAULT results for 
unreasonable values of pmap_data. The flags bits are as defined above: 
PMAP_MAPPED tells if the unit is currently mapped, PMAP_EXCL indicates 
that exclusive use is currently in effect, and PMAP_NPMEM indicates that fd 
is configured as a non-paged memory device. 


doctl(fd, PMAPIOCSETP, pmap_data) 
int fd; 
structpmap joc *pmap_data; 


PMAPIOCSETP allows a root process to set entries in the driver’s pmap_unit 
table. EPERM results if the caller is not root. EFAULT results for unreason- 
able values of pmap_data. EBUSY results if the unit is mapped at the time of 
this call. EINVAL results if pi_paddr or pi_size is not a multiple of the system 
page size. The driver cannot verify the legality of the physical addresses pas- 
sedin: user beware. 

Only the PMAP_NPMEM flag bit is copied from pi_flags to pm_flags. Use 
PMAPIOCEXCL or PMAPIOCNXCL to set or clear the PMAP_EXCL bit. 
NOTE: This ioct] allows the superuser to associate a file with any range of 
physical addresses, including MULTIBUS mapping registers, nonexistent 
memory, etc. Specifying incorrect values for pi_paddr or pi_size can lead to 
catastrophic results. 


doct1(fd, PMAPIOCEXCL, 0) 
int fd; 


PMAPIOCEXCL verifies that there is at most one open at the time of the ioctl, 
and ensures that no further (non-superuser) opens are allowed on the unit 
until it is closed or the PMAPIOCNXCL ioctl is called. PMAPIOCEXCL fails 
(returning EBUSY) if there is already more than one open. Any process may 
execute this call. Note that the semantics are similar, but not identical, to 
TIOCEXCLin the terminal driver. 


Loct1l(fd, PMAPIOCNXCL, 0) 
int fd; 


PMAPIOCNXCL disables exclusive use of the unit, thus allowing further 
opens. Any process may execute this call. 

SEE ALSO 
mmap(2seq), pmap(1M), getpagesize(2seq) 


2 12/89 


DYNIX/ptx 8A(7) 


NAME 
SA — devices administered by System Administration 


DESCRIPTION - 
The files in the directories /dev/SA (for block devices) and the /dev/rSA (for 
raw devices) are used by sysadm System Administration to access the devices 
on which it operates. Not all /dev/(r)SA entries are used by all System 
Administration commands and not all possible devices will have links in these 
directories. If there are devices that you want supported from within 
sysadm, you need to create hard links from /dev/SA/ to them. 


FILES 
/dev/SA 
/devirSA 


SEE ALSO 
sysadm(1) 
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NAME 
& SCED — SCSI/Ethernet/Diagnostics board 


CONFIGURATION ENTRY 
sec ctrl on s8b8000 unit ? 
sec_scsi scsi_busno on sec ctrl unit ? 


DESCRIPTION 
The Sequent SCSI/Ethernet/Diagnostics board is a Sequent computer system 
board which contains two console ports, an Ethernet interface and a SCSI bus 
interface. The SCED board number is specified by cérl in the configuration 
entry. The SCSI bus number scsi_busno must be assigned to each bus in 
sequential order starting at zero. The SCED unit number, unit , must be 
specified with "2" in the two configuration entries shown above. The "?" isa 
wild-card that allows the autoconfiguration subsystem to assign correct unit 
numbers. 


The SCED-based console ports are automatically configured for each config- 
ured SCED. 


SEE ALSO 
ts(7), console(7) 


12/89 1 


DYNIX/ptx 8D(7) 


NAME 


sd — SCSI disk controller 


CONFIGURATION ENTRY 


sd on sec_sesi sec_scsi unit unit 


DESCRIPTION 


This device driver controls both SCSI disk target adapters and SCSI disks 
with embedded targets ("embedded SCSI" disks). It supports up to eight disks 
per target adapter, with a maximum of seven target adapters per SCED 
board, or it can support a maximum of seven embedded SCSI disks per SCED 
board. 


The SCSI disk is located on SCED SCSI bus sec_scsi and is configuration unit 
number unit. The configuration unit number is an index into the sec_scsi_con- 
fig table in the file /etc/conf/uts/io/sec/sec_space.c , which specifies the tar- 
get adapter number, the logical unit number, and whether or not it is an 
embedded SCSI disk. The unit number must be unique with respect to other 
devices on this SCED SCSI bus. Both the sec_scsi and unit may be specified 
with a "?,” meaning they are wild-carded. If sec_scsi is wild-carded, the system 
will assign the number of the SCED SCSI bus on which the disk is physically 
located. If unit is wild-carded, the system will assign the configuration unit 
number of the first unused matching entry in the sec_scsi_config table. A disk 
matches if its target adapter number matches the target adapter number 
specified in the sec_scsi_config table entry. Mixing of embedded SCSI and tar- 
get adapters is not allowed on one system. 


The special file with minor device number 255 refers to drive sd0 (the first 
drive listed in the kernel configuration file), minor device number 511 refers to 
sdl, and so on. Standard device names are of the form sdz, where n is the 
drive number. 


Block devices access the disk via the system’s normal buffering mechanism, 
and may be read and written without regard to physical disk records. These 
special files are usually found in /dev/dsk — for example, /dev/dsk/sd0. 
There is also a raw interface that provides for direct transmission between the 
disk and the user’s read or write buffer. Raw transfers are limited to a maxi- 
mum of 254 512-byte sectors. In raw I/O, counts must be a multiple of 512 
bytes, and must begin on 16-byte aligned memory addresses. Likewise, Ilseek 
calls should specify a multiple of 512 bytes. A single read or write call usually 
results in exactly one I/O operation, which transfers data directly to the users 
address space. Therefore raw I/O is considerably more efficient when many 
words are transmitted. The names of the raw special files are conventionally 
the same as the block special files, and are found in the directory /dev/rdsk — 
e.g., /dev/rdsk/sd0. 

NOTE: The sd driver provides access to the entire disk, including reserved 
sectors. To make the device usable, a partitioning driver (like vtoc(7) or 
empt(7)) must be built on the unpartitioned disk. 


BINARY CONFIGURATION 
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Before attempting to add a new disk or target adapter, read the disk and tar- 
get adapter manuals thoroughly. For this application, the most important 
information is how to set the target adapter number and drive-select cabling. 
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Table of disk units 


The sdbconf array in the device driver binary configuration file 
(/etc/conf/uts/io/sd/sd_space.c) must contain an entry for each drive that 
may be configured; the entries must be in the same order as the “device” 
entries in the kernel configuration file. When adding a new drive, make sure 
that the corresponding entry in sdbconf points to the partition table for the 
appropriate drive type. (As installed, sdbconf has entries for 8 drives, all 
using the same partition table. Superfluous entries are ignored; you must add 
more entries if you have more than 8 drives.) 


Tuning Parameters 


The following tuning parameters are defined for each drive in the sdbconf 
array of the binary configuration file: (1) the buffer size for ioct] operations, 
(2) the number of IATs (indirect access table entries, used for scatter/gather 
J/O), and (3) water marks to lessen the interrupt load on the SCED board. 


IATs 


An indirect access table is used to map a contiguous I/O buffer in virtual mem- 
ory to the corresponding pages scattered throughout physical memory. Each 
table entry (IAT) can map up to 2048 bytes. The number of IATs directly 
affects the total number of of outstanding requests that the device driver can 
queue to the SCED board. Groups of IATs are allocated on a per-transfer 
basis, and there must be enough entries to handle at least one request. 


Water Marks : 


FILES 


The water marks are low and thresh(hold). The device driver will queue up a 
maximum of thresh requests in a drive’s device output queue before inter- 
rupting the SCED board to handle the requests. The low water mark is used 
when the device input queue has been filled and is draining off. The device 
driver does not begin queueing requests again until the “low” water mark has 
been reached. (The size of a drive’s device input and output queues is defined 
by the “doneq” and “req” fields of the corresponding “device” entry in the ker- 
nel configuration file.) 


/dev/dsk/sd?s? Block files 

/dev/rdsk/sd?s? Raw files 
/etc/conf/uts/io/sd/sd_space.c Binary configuration file 
/etc/conf/uts/io/sec/sec_space.c SEC SCSI configuration table 


SEE ALSO 


devbuild(1M), mkvtoc(1M), newfs(1M), prtvtoc(1M), vtoc(7), cmpt(7), CCSfor- 
mat(8) 


DIAGNOSTICS 


BUGS 


See the ANSI X3T9.2 (SCSI) specification. 


In raw I/O, read(2),write(2), and Iseek(2) should always deal in 512-byte mul- 
tiples. 


A program to analyze the logged error information (even in its present 
reduced form) is needed. Error messages should be more consistent. 


The kernel “milliseconds per seek” statistic is not kept for this device; thus, 
iostat(1) always reports zero for this statistic. 
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When a request to the disk accesses past the end of media (for example, a non- 
existent block number), the device driver will report soft errors followed by a 
hard error in the same way that a bad block is treated. There is no special 
handling of the volume overflow sense error code for disks. 
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NAME 


sp — STREAMS pipe device 


-_) CONFIGURATION ENTRY 


pseudodevice sp [ count ] 


DESCRIPTION 
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The sp driver provides a machine-local interprocess communication mecha- 
nism using streams. The communication mechanism works by cross-connect- 
ing the "bottom" of two streams, so that writes to one stream can be read on 
the other. To facilitate selection of an unused streams pipe device, the sp 
device driver automatically allocates the next available master when invoked 
from the STREAMS clone device driver by opening /dev/spx (see clone(7)). An 
open file descriptor with read and write access to a streams pipe device is 
returned. 


To use a streams pipe, the application must first open two streams pipe 
devices (either by explicit name or by clone open). Call the file descriptors 
returned from the opens fd0 and fd1. Next, the application must “connect” the 
two streams pipes (fd0 and fd1) using a I FDINSERT ioct] (see streamio(7)). 


Once two streams pipes are connected, a write on one "end" of the pipe can be 
read on the other end. A write of data onto fd0 can be read on fd1, and vice- 
versa. This communication scheme differs from regular pipes in that it’s "full 
duplex.” 


Streams pipes provide machine local, bidirectional communication with all the 
basic interfaces available to streams: the application can poll() on streams 
file descriptors, and it can use either byte-oriented (read(), readv(Q), write(), 
writev()) or record-oriented transfers (getmsg()/putmsg(). 


Streams pipes have another facility, called "file descriptor passing.” The 
mechanism uses _SENDFD, and I_RECVFD ioctl()’s to pass an open file 
descriptor from one process to another through a streams pipe (see 
streamio(7)). With this mechanism, it’s possible for unrelated processes to 
have pointers to the same file table entry. This can be used to create a cli- 
ent/server communication structure. The facility works like this: 


fd0 and fd1 are streams pipes which are opened and connected by the parent 
process of a pool of servers. The parent then does a mknod() system call to 
create a character special file on disk with the major/minor numbers of fd1, 
and giving it a name, for example server_head. server_head is now a globally 
accessible name for the fd1 end of the server’s streams pipe. Every member of 
the server pool will then do ioctl(fd0, IRECVFD, &fdstructure). Each 
server will block until it receives a file descriptor. This file descriptor will be 
from a client wanting to communicate with a server. This file descriptor may 
be for one end of another streams pipe pair, or it may be for an ordinary pipe 
or even a disk file. The server can then converse with the client through the 
passed file descriptor. When the conversation is finished, the server can close 
the passed fd and wait again at the ioctl(). 


The client wanting to talk with a server first creates its own connected 
streams pipe pair, e.g., getting back fda and fdb. Then, it would open the spe- 
cial file server_head (see above) created by the first server, receiving a file 
descriptor fdc. The client can then perform the system call ioctl(fde, 
I_LSENDFD, fda) to send the file descriptor for one of the pipe ends for his 
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streams pipe to a server. The server and client can then communicate over 
the streams pipe created by the client, using file descriptors fda and fdb. © 


SEE ALSO 
streams(7), clone(7), streamio(7) 
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NAME 
& SSM — System Services Module 


CONFIGURATION ENTRY 
ssm ctrl on sb8000 unit ? 
ssm_scsi scsit_busno on ssm ctrl unit ? 
vme ume_busno on ssm ctrl unit ? 


DESCRIPTION 
The System Services Module (SSM) is a Sequent computer system board that 
contains two console ports, a SCSI interface, a VMEbus interface and a paral- 
lel printer port interface. The SSM number is specified by crtl in the confi- 
guration entry. The SCSI bus number scsi_busno, and the VME bus number 
ume_busno, must be assigned in sequential order starting at zero. The SSM 
unit number, unit , must be specified with "?" in all three configuration 
entries shown above. The "?" is a wild-card that allows the autoconfiguration 
subsystem to assign correct unit numbers. 


The SSM-based console ports and printer ports are automatically configured 
for each configured SSM. 


SEE ALSO 
tm(7), console(7), wd(7), wp(7) 
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NAME 


st — Systech MTI-800/1600/1650 terminal multiplexor driver 


@ CONFIGURATION ENTRY 


st on multibus multibus unit unit segsize 1024nsegs 16 


DESCRIPTION 


An MTI-800 provides 8 serial lines; an MTI-1600/1650 provides 16 serial lines. 
Each line of the MTI-800/1600/1650 is configurable to support a modem or a 
terminal. 


The controller board is located on MULTIBUS multibus and is configuration 
unit number unit. The configuration unit number is an index into the st_mul- 
tibus_config table in the file /etc/conf/uts/io/st/st_space.c. The unit number 
must be unique with respect to other st devices on this MULTIBUS. Both the 
multibus and unit may be specified with a "?," meaning they are wild-carded. 
If multibus is wild-carded, the system will assign the number of the MUL- 
TIBUS in which the board is physically located. If unit is wild-carded, the sys- 
tem will assign the configuration unit number of the first unused matching 
entry in the st_multibus_config table. A board matches if it is at the address 
specified in the st_multibus_config table entry. The interrupt vector cannot be 
checked, so care must be taken to ensure that the interrupt vector is jumpered 
to match the st_multibus_config table entry. The segsize field is the size of 
address space reserved for DMA transfers and must be 1024. The nsegs field 
indicates how many regions to reserve for DMA transfers for this device and 
must be 16. 


Each line attached to the MTI-800/1600/1650 terminal multiplexor behaves as 
described in streamtty(7). Input and output for each line may independently 
be set to run at any of the following speeds: B50, B75, B11Q B134, B150, 
B300, B600, B1200, B1800, B2400, B4800, B9600, and B19200 


The hardware signals DTR and RTS are enabled when the line is opened and 
disabled when the line is closed if the HUPCL flag is set. ‘These signals may 
be changed via ioctl calls to the device driver and are used when in input flow 
control is enabled. Break detection and generation are also supported. See 
termio(7) for the encoding scheme. 

The initial baud rate and line state for all lines are defined by the stcflags 
variable in the binary configuration file, st_space.c. These values are usually 
overridden (e.g., by getty(1a)) when a line is opened. 


Streams Driver Characteristics 
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The st driver is a STREAMS-based tty driver as described in streamtty(7). 
Functionality unique to this driver is described below: 

When a set-parameters ioct] message is received with a baud rate of BO, this is 
considered to be a hangup message. DTR and RTS lines are dropped immedi- 
ately. 

If a set-parameters ioct] message is received with an illegal baud rate, the 
message will be rejected and the line state will not be changed. 

The Systech hardware is not allowed to perform any flow control. The 1d0 
module and the driver execute all flow contro] processing. If the driver 
receives an M_PCCTL message with a sub-type of MC_STOPI or MC_STARTI, 
only the first data byte in the message is sent to the peripheral device. 
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If the driver receives an M_IOCTL/M_PCIOCTL message with a sub-type of 

TCGETA/TCGETP and the message does not arrive with a pre-allocated data 

buffer, the driver will allocate a streams buffer and attach it to the message. 

Autodialer Support 

For normal Systech operation, the DCD input must be active to allow the 

USART receiver to operate. A port can be specially wired to support an auto- 

dial modem (both dial-out and dial-in on the same line) without requiring the 

modem’s DCD to be active. The special rewiring consists of the following 

steps. 

1) Disconnect pins 4 (RTS), 8 (DCD), 6 (DSR) from the modem to the Sequent 
system. 

2) Loop pin 4 (RTS) to pin 8 (DCD) on the backpanel board of the Sequent 
system. 

3) Connect pin 8 (DCD) from the modem to pin 6 (DSR) on the Sequent sys- 
tem. 


The following table illustrates the specially-wired connection. 


Sequent system Terminal 
(Male conn.) (Female conn.) 
Pin # Pin # Description 

2 to 2 TxD driven by Sequent system 
3 to 3 RxD driven by Modem 
5 to 5 CTS driven by Modem 
6 to 8 DCD driven by Modem 
7 to 7 Signal Ground 

20 to 20 DTR driven by Sequent system 


Pin 4 is looped back to Pin 8 on the Sequent system side. 
A logic-high-to-logic-low transition on the auto-dialer’s DCD output is inter- 
preted as a hangup signal. 
FILES 
/dev/tty<subdir>/<basename> /etc/conf/uts/o/st/st_space.c 
SEE ALSO 
tty(7), streamtty(7) 
BUGS 


The Systech MTI-800/1600 board does not use a DMA input transfer scheme. 
Therefore, excessive overrun errors may result under heavy load. 
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NAME 


streamio — STREAMS ioct] commands 


DESCRIPTION - 


STREAMS [see intro(2)] ioctl] commands are a subset of ioct](2) system calls 
which perform a variety of control functions on streams. The arguments com- 
mand and arg are passed to the file designated by fildes and are interpreted by 
the stream head. Certain combinations of these arguments may be passed to a 
module or driver in the stream. 


fildes is an open file descriptor that refers to a stream. command determines 
the control function to be performed as described below. arg represents addi- 
tional information that is needed by this command. The type of arg depends 
upon the command, but it is generally an integer or a pointer to a command- 
specific data structure. 


Since these STREAMS commands are a subset of ioctl, they are subject to the 
errors described there. In addition to those errors, the call will fail with errno 
set to EINVAL, without processing a control function, if the stream referenced 
by fildes is linked below a multiplexor, or if command is not a valid value for a 
stream. 


Also, as described in ioctl, STREAMS modules and drivers can detect errors. In 
this case, the module or driver sends an error message to the stream head con- 
taining an error value. This causes subsequent system calls to fail with errno 

set to this value. - 


BINARY CONFIGURATION 
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Autopush is a mechanism for automatically pushing a module when a stream 
is first opened. The following structure is used to define the actions taken: 


struct st_ap { 
char strap driver [FMNAMES2+1]; 
unsigned int strap_lminor; 
unsigned int strap_hminor; 
char strap_module {FMNAMESZ+1]; 
int strap_next; 

} str_ap(]; 


If a streams module whose name matches strap_driver is opened and the 
minor is within the range 


strap_lminor < minor < strap_hminor 


then "strap_module” is pushed. If"strap_next" is not equal to -1, it is used to 
index the table, and its "strap_module" is pushed. Each time a module is 
pushed, the corresponding entry is searched for in the table, and, if found the 
specified modules are pushed instead of the one named. Thus the driver speci- 
fies a list of modules to be pushed and each module specifies a list of compo- 
nents. The table is initialized in the kernel configuration file 

/etc/conf/uts / kernel /i386_space /autop_space.c. If an error during the push 
occurs, the open fails. 


STREAMIO(7) 
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The terminal ioctl(2) system calls have the form: 


#include <sys/types.h> 
#include <streamio.h> or #include <streamios.h> 


int ioctl (fildes, command, arg) 
The following ioct! commands, with error values indicated, are applicable to 
all STREAMS files: 


PUSH 


POP 


LLOOK 


LFLUSH 


LSETSIG 


Pushes the module whose name is pointed to by arg onto the top 
of the current stream, just below the stream head. It then calls 
the open routine of the newly-pushed module. On failure, errno 
is set to one of the following values: 


(EFAULT] arg points outside the allocated address space. 
[EINVAL] Invalid module name. 

(ENXIO] Open routine of new module failed. 

[ENXIO] Hangup received on fildes. 


Removes the module just below the stream head of the stream 
pointed to by fildes. arg should be 0 in an I_LPOP request. On 
failure, errno is set to one of the following values: 


[EINVAL] No module present in the stream. 
[ENXIO} Hangup received on fildes. 


Retrieves the name of the module just below the stream head of 
the stream pointed to by fildes, and places it in a null ter- 
minated character string pointed at by arg. The buffer pointed 
to by arg should be at least FMNAMESZ+1 bytes long. An 
[#include <sys/conf.h>] declaration is required. On fail- 
ure, errno is set to one of the following values: 


(EFAULT] arg points outside the allocated address space. 
[EINVAL] No module present in stream. 


This request flushes all input and/or output queues, depending 
on the value of arg. Legal arg values are: 


FLUSHR Flush read queues. 

FLUSHW Flush write queues. 

FLUSHRW ‘Flush read and write queues. 

On failure, errno is set to one of the following values: 

[EINVAL] Invalid arg value. 

[ENOSR] Unable to allocate buffers for flush message due 
to insufficient STREAMS memory resources. 

[ENXIO] Hangup received on fildes. 


Informs the stream head that the user wishes the kernel to 
issue the SIGPOLL signal [see signal(2) and sigset(2)] when a 
particular event has occurred on the stream associated with 
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LGETSIG 


FIND 
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fildes. |_SETSIG supports an asynchronous processing capability 
in STREAMS. The value of arg is a bitmask that specifies the 
events for which the user should be signaled. It is the bit- 
wise-OR of any combination of the following constants: 


S_INPUT Anon-priority message has arrived on a stream 
head read queue, and no other messages existed 
on that queue before this message was placed 
there. This is set even if the message is of zero 


length. 


S_HIPRI A priority message is present on the stream head 
read queue. This is set even if the message is of 
zero length. 


S_OUTPUT The write queue just below the stream head is no 
longer full. This notifies the user that there is 
room on the queue for sending (or writing) data 
downstream. 


S_MSG ASTREAMS signal message that contains the SIG- 
POLL signal has reached the front of the stream 
head read queue. 


A.user process may choose to be signaled only of priority mes- 
sages by setting the arg bitmask to the value S_HIPRI. 


Processes that wish to receive SIGPOLL signals must explicitly 
register to receive them using I_SETSIG. If several processes 
register to receive this signal for the same event on the same 
Stream, each process will be signaled when the event occurs. 


If the value of arg is zero, the calling process will be unre- 
gistered and will not receive further SIGPOLL signals. On fail- 
ure, errno is set to one of the following values: 


(EAGAIN] Allocation of a data structure to store the signal 
request failed. 


(EINVAL] arg value is invalid or arg is zero and process is 
not registered to receive the SIGPOLL signal. 


Returns the events for which the calling process is currently 
registered to be sent a SIGPOLL signal. The events are returned 
as a bitmask pointed to by arg, where the events are those 
specified in the description of ILSETSIG above. On failure, errno 
jis set to one of the following values: 


(EFAULT] arg points outside the allocated address space. 


{EINVAL] Process not registered to receive the SIGPOLL sig- 
nal 


Compares the names of all modules currently present in the 
stream to the name pointed to by arg, and returns 1 if the 
named module is present in the stream. It returns 0 if the 
named module is not present. On failure, errno is set to one of 
the following values: 
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(EFAULT] arg points outside the allocated address space. 
[EINVAL] arg does not contain a valid module name. i & 


PEEK Allows a user to retrieve the information in the first message on 
the stream head read queue without taking the message off the 
queue. arg points to a strpeek structure which contains the fol- 


lowing members: 
struct strbuf ctlbuf; 
struct strbuf databuf; 


long flags; 


The maxlen field in the ctlbuf and databuf strbuf structures [see 
getmsg(2)] must be set to the number of bytes of control infor- 
mation and/or data information, respectively, to retrieve. Ifthe 
user sets flags to RS_HIPRI, I_PEEK will only look for a priority 
message on the stream head read queue. 


1_PEEK returns 1 if a message was retrieved, and returns 0 if no 
message was found on the stream head read queue, or if the 
RS_HIPRI flag was set in flags and a priority message was not 
present on the stream head read queue. It does not wait for a 
message to arrive. On return, ctlbuf specifies information in the 
control buffer, databuf specifies information in the data buffer, 
and flags contains the value 0 or RS_HIPRI. On failure, errno is 


set to the following value: 
(EBADMSG] Queued message to be read is not valid for 
PEEK. 


[EFAULT] arg points, or the buffer area specified in ctlbuf or 
databuf is, outside the allocated address space. 


LSRDOPT _ Sets the read mode using the value of the argument arg. Legal 
arg values are: 
RNORM __s Byte-stream mode, the default. 
RMSGD Message-discard mode. 
RMSGN Message-nondiscard mode. 
Read modes are described in read(2). On failure, errno is set to 
the following value: 
[EINVAL] arg is not one of the above legal values. 


LGRDOPT Returns the current read mode setting in an int pointed to by 
the argument arg. Read modes are described in read(2). On 
failure, errno is set to the following value: 


(EFAULT] arg points outside the allocated address space. 


ILNREAD Counts the number of data bytes in data blocks in the first mes- 
sage on the stream head read queue, and places this value in the 
location pointed to by arg. The return value for the command is 
the number of messages on the stream head read queue. For 
example, if zero is returned in arg, but the ioctl return value is 
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greater than zero, this indicates that a zero-length message is 
next on the queue. On failure, errno is set to the following 
value: 


[EFAULT] arg points outside the allocated address space. 


Creates a message from user specified buffer(s), adds informa- 
tion about another stream and sends the message downstream. 
The message contains a control part and an optional data part. 
The data and control parts to be sent are distinguished by place- 
ment in separate buffers, as described below. 


arg points to a strfdinsert structure which contains the follow- 
ing members: 


struct strbuf ctlbuf; 
struct strbuf databuf; 
long flags; 
int fildes; 
int offset; 


The len field in the ctlbuf strbuf structure [see putmsg(2)] must 
be set to the size of a pointer plus the number of bytes of control 
information to be sent with the message. fildes in the strfdin- 
sert structure specifies the file descriptor of the other stream. 
offset, which must be word-aligned, specifies the number of 
bytes beyond the beginning of the control buffer where I_LFDIN- 
SERT will store a pointer. This pointer will be the address of the 
read queue structure of the driver for the stream corresponding 
to fildes in the strfdinsert structure. The len field in the databuf 
strbuf structure must be set to the number of bytes of data 
information to be sent with the message or zero if no data part 
is to be sent. 


flags specifies the type of message to be created. A non-priority 
message is created if flags is set to 0, and a priority message is 
created if flags is set to RS_HIPRI. For non-priority messages, 
I_FDINSERT will block if the stream write queue is full due to 
internal flow control conditions. For priority. messages, J_FDIN- 
SERT does not block on this condition. For non-priority mes- 
sages, I FDINSERT does not block when the write queue is full 
and O_NDELAY is set. Instead, it fails and sets errno to EAGAIN. 


I_FDINSERT also blocks, unless prevented by lack of internal 

resources, waiting for the availability of message blocks in the 

stream, regardless of priority or whether O_NDELAY has been 

specified. No partial message is sent. On failure, errno is set to 

one of the following values: 

[EAGAIN] Anon-priority message was specified, the O_NDE- 
LAY flag is set, and the stream write queue is full 
due to internal flow control conditions. 


[EFAULT] arg points, or the buffer area specified in ctlbuf or 
databuf is, outside the allocated address space. 
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[EINVAL] One of the following: fildes in the strfdinsert 
structure is not a valid, open stream file descrip- 
tor; the size of a pointer plus offset is greater than 
the len field for the buffer specified through ct/ptr; 
offset does not specify a properly-aligned location 
in the data buffer; an undefined value is stored in 
flags. 

[ENOSR] Buffers could not be allocated for the message 
that was to be created due to insufficient 
STREAMS memory resources. 


[ENXIO] Hangup received on fildes of the ioctl call or fildes 
in the strfdinsert structure. 


(ERANGE] The len field for the buffer specified through data- 
buf does not fall within the range specified by the 
maximum and minimum packet sizes of the top- 
most stream module, or the len field for the buffer 
specified through databuf is larger than the maxi- 
mum configured size of the data part of a mes- 
sage, or the len field for the buffer specified 
through ctlbuf is larger than the maximum con- 
figured size of the control part of a message. 


I_FDINSERT can also fail if an error message was received by 
the stream head of the stream corresponding to fildes in the 
strfdinsert structure. In this case, errno will be set to the value 
in the message. 


Constructs an internal STREAMS ioct] message from the data 
pointed to by arg, and sends that message downstream. 


This mechanism is provided to send user ioctl requests to down- 
stream modules and drivers. It allows information to be sent 
with the ioc#l, and will return to the user any information sent 
upstream by the downstream recipient. I_STR blocks until the 
system responds with either a positive or negative acknowledge- 
ment message, or until the request "times out” after some 
period of time. If the request times out, it fails with errno set to 
ETIME. 


At most, one I_STR can be active on a stream. Further I_LSTR 
calls will block until the active STR completes at the stream 
head. The default timeout interval for these requests is 15 sec- 
onds. The O_NDELAY [see open(2)] flag has no effect on this call. 


To send requests downstream, arg must point to a strioctl struc- 
ture which contains the following members: 


int ic_cmd; /* downstream command */ 
int ic_timout; /* ACK/NAK timeout */ 
int ic_len; /* length of data arg */ 
char*ic dp; /* ptr to data arg */ 
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ic_cmd is the internal ioct] command intended for a downstream 
module or driver and ic_timout is the number of seconds (-1 = 
infinite, 0 = use default, >0 = as specified) an I_STR request will 


“wait for acknowledgement before timing out. ic_len is the num- 


ber of bytes in the data argument and ic_dp is a pointer to the 
data argument. The ic_len field has two uses: on input, it con- 
tains the length of the data argument passed in, and on return 
from the command, it contains the number of bytes being 
returned to the user (the buffer pointed to by ic_dp should be 
large enough to contain the maximum amount of data that any 
module or the driver in the stream can return). 


The stream head will convert the information pointed to by the 

strioctl structure to an internal ioct] command message and 

send it downstream. On failure, errno is set to one of the follow- 

ing values: 

(EFAULT] arg points, or the buffer area specified by ic_dp 
and ic_len (separately for data sent and data 
returned) is, outside the allocated address space. 


[EINVAL] ic_len is less than 0 or ic_len is larger than the 
maximum configured size of the data part of a 
message or ic_timnout is less than -1. 


[ENOSR] Unable to allocate buffers for the ioctl message 
due to insufficient STREAMS memory resources. 


[ENXIO] Hangup received on fildes. 


(ETIME] A downstream ioctl timed out before acknowl- 
edgement was received. 


An L_STR can also fail while waiting for an acknowledgement if 
@ message indicating an error or a hangup is received at the 
stream head. In addition, an error code can be returned in the 
positive or negative acknowledgement message, in the event the 
ioctl command sent downstream fails. For these cases, I_LSTR 
will fail with errno set to the value in the message. 


Requests the stream associated with fildes to send a message, 
containing a file pointer, to the stream head at the other end of 
a stream pipe. The file pointer corresponds to arg, which must 
be an integer file descriptor. 


ILSENDFD converts arg into the corresponding system file 
pointer. It allocates a message block and inserts the file pointer 
in the block. The user ID and group ID associated with the 
sending process are also inserted. This message is placed 
directly on the read queue [see intro(2)] of the stream head at 
the other end of the stream pipe to which it is connected. On 
failure, errno is set to one of the following values: 


[EAGAIN] The sending stream is unable to allocate a mes- 
sage block to contain the file pointer. 
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[EAGAIN] The read queue of the receiving stream head is 
full and cannot accept the message sent by 
LSENDFD. 

[EBADF] arg is not a valid, open file descriptor. 

[EINVAL] fildes is not connected to a stream pipe. 

[ENXIO] Hangup received on fildes. 


LRECVFD Retrieves the file descriptor associated with the message sent by 
an LSENDFD ioctl over a stream pipe. arg is a pointer to a data 
buffer large enough to hold an strrecufd data structure contain- 
ing the following members: 


int fd; 

unsigned short uid; 
unsigned short gid; 
char fi11[8]; 


fd is an integer file descriptor. uid and gid are the user ID and 
group ID, respectively, of the sending stream. 


If O_NDELAY is not set [see open(2)], I RECVFD will block until a 
message is present at the stream head. If O_NDELAY is set, 
LRECVFD will fail with errno set to EAGAIN if no message is 
present at the stream head. 


If the message at the stream head is a message sent by an 
I_SENDFD, a new user file descriptor is allocated for the file 
pointer contained in the message. The new file descriptor is 
placed in the fd field of the strrecufd structure. The structure is 
copied into the user data buffer pointed to by arg. On failure, 
errno is set to one of the following values: 


[EAGAIN] A message was not present at the stream head 
read queue, and the O_NDELAY flag is set. 


[EBADMSG] The message at the stream head read queue was 
not a message containing a passed file descriptor. 


(EFAULT] arg points outside the allocated address space. 
[EMFILE] NOFILES file descriptors are currently open. 
[ENXIO] Hangup received on fildes. 


The following two commands are used for connecting and disconnecting multi- 
plexed STREAMS configurations. 


LLINK Connects two streams, where fildes is the file descriptor of the 
stream connected to the multiplexing driver, and arg is the file 
descriptor of the stream connected to another driver. The 
stream designated by arg gets connected below the multiplexing 
driver. I_LINK requires the multiplexing driver to send an 
acknowledgement message to the stream head regarding the 
linking operation. This call returns a multiplexor ID number 
(an identifier used to disconnect the multiplexor see IUNLINK) 
on success, and a -1 on failure. On failure, errno is set to one of 
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the following values: 


[EAGAIN] Temporarily unable to allocate storage to perform 
the LINK. 


[EBADF] arg is not a valid, open file descriptor. 
[EINVAL] fildes stream does not support multiplexing. 


[EINVAL] arg is not a stream, or is already linked under a 
multiplexor. 


[EINVAL] The specified link operation would cause a “cycle” 
in the resulting configuration; that is, if a given 
stream head is linked into a multiplexing confi- 
guration in more than one place. 


[ENOSR] Unable to allocate storage to perform the I_LINK 
due to insufficient STREAMS memory resources. 


{ENXIO] Hangup received on fildes. 


[ETIME] Time out before acknowledgement message was 
received at stream head. 


An I_LINK can also fail while waiting for the multiplexing driver 
to acknowledge the link request if a message indicating an error 
or a hangup is received at the stream head of fildes. In addition, 
an error code can be returned in the positive or negative 
acknowledgement message. For these cases, I_LINK will fail 
with errno set to the value in the message. 


Disconnects the two streams specified by fildes and arg. fildes is 
the file descriptor of the stream connected to the multiplexing 
driver. fildes must correspond to the stream on which the ioctl 
LLINK command was issued to link the stream below the multi- 
plexing driver. arg is the multiplexor ID number that was 
returned by the I_LINK. If arg is -1, then all Streams which 
were linked to fildes are disconnected. As in I_LINK, this com- 
mand requires the multiplexing driver to acknowledge the 
unlink. On failure, errno is set to one of the following values: 


[ENXIO} Hangup received on fildes. 


[ETIME] Time out before acknowledgement message was 
received at stream head. 


[ENOSR] Unable to allocate storage to perform the 
ILUNLINK due to insufficient STREAMS memory 
resources. 


[EINVAL] arg is an invalid multiplexor ID number or fildes 
is not the stream on which the _LINK that 
returned arg was performed. 


An ILUNLINK can also fail while waiting for the multiplexing 
driver to acknowledge the link request, if a message indicating 
an error or a hangup is received at the stream head of fildes. In 
addition, an error code can be returned in the positive or nega- 
tive acknowledgement message. For these cases, I UNLINK fails 
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with errno set to the value in the message. 
SEE ALSO @ 
close (2), fentl (2), intro (2), ioctl (2), open (2), read (2), getmsg (2), poll (2), 
putmeg (2), signal (2), sigset (2), write (2) 
DIAGNOSTICS 
Unless specified otherwise above, the return value from ioctl is 0 upon success 
and -1 upon failure with errno set as indicated. 
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NAME 


streampty — STREAMS pseudo terminal driver 


@ CONFIGURATION ENTRY 


pseudodevice pty count 


DESCRIPTION 
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The pty driver provides support for a device-pair termed a pseudo terminal. A 
pseudo terminal is a pair of character devices, a master device (also known as 
a controller device) and a slave device. The slave device provides processes an 
interface identical to that described in termio(7). However, whereas all other 
devices which provide the interface described in termio(7) have a hardware 
device of some sort behind them, the slave device has, instead, another process 
manipulating it through the master half of the pseudo terminal. That is, any- 
thing written on the master device is given to the slave device as input and 
anything written on the slave device is presented as input on the master 
device. 


Usually only one process has the master device opened while several processes 
may have the slave device opened. An attempt to open a master device which 
is currently in use (already open) will fail with errno set to [EIO]. (However, 
an already open file descriptor for a master device can be duplicated via either 
dup(2) or fork(2).) To facilitate selection of an unused master device, the 
master device driver automatically allocates the next available master when 
invoked from the STREAMS clone device driver by opening /dev/getpty. An 
open file descriptor to the selected master device is returned. The selected 
master/slave pty pair can be identified via a TIOCPTYDEV ioctl(2) call 
against the opened master. Typically, a process selects an available master 
device via getpseudotty(3SEQ) which automatically performs these steps. 


Note that while it is not possible to open a master device which is aleady open, 
it is possible to open a master device which is closed but whose corresponding 
slave device is currently opened by one or more processes. To prevent these 
possible processes from interfering with future pty use, fvhangup(2SEQ) can 
be used on the slave device after opening it. 


While the slave device supports the full set of ioctl(2) calls desribed in ter- 
mio(7), the master device supports only the following set. 


The master device ioctl(2) system calls have the form: 


#finclude <sys/types.h> 
#include <termio.h> 
#include <sys/strpty.h> 


int ioctl (fildes, command, arg) 
Where fildes is an open master device file descriptor. arg is of different types 
depending on the command. Valid command values are: 
TIOCGWINSZ Get the current winsize structure settings of the slave device. 
See the description in termio(7). 
TIOCSWINSZ Set the current winsize structure settings of the slave device. 
See the description in termio(7). 
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TIOCPTYDEV Get the major and minor numbers of both the master and slave 
devices and store in the ptydev structure referenced by arg. 
This structure has the form: 


struct ptydev { 
unsigned intptym_major; /* master major number */ 
unsigned intptym_minor; /* master minor number */ 
unsigned intptys_major; /* slave major number */ 
unsigned intptys_minor; /* slave minor number */ 
} 


If a temporary lack of system resources prevents an ioctl() from being success- 
fully executed, the ioctl() returns —1 with errno set to [EAGAIN]. In this 
case, the caller should retry the ioctl(), possibly after waiting a short period of 
time. 

SLAVE DEVICE DRIVER 
The slave device pty driver is a STREAMS driver that implements the 
streamtty(7) interface with the following exceptions: 


Terminal State Parameters 
All baud rate values in c_cflag are ignored. 


Opening a Slave Device File 
If the CLOCAL (c_cflag) mode is set, or if either the O_NONBLOCK or the 
O_NDELAY flag is specified in the open(2), the open will not wait for an open 
on the corresponding master device to be present before succeeding. All other 
c_cflag flag bits are ignored. 


Controlling terminal allocation is performed as described in streamtty(7). 


All other termio(7) functions must be performed by STREAMS modules pushed 
on top of the slave driver; these are typically performed by 1d0(7). 


Closing a Slave Device File 
The last process to close the slave device will cause the driver close routine to 
be called. This, in turn, will send an MLERROR message up the master device 
stream causing all subsequent access to the master device by an application to 
fail with errno set to [EIO]. 


General STREAMS Concerns 

M_FLUSH message processing is handled somewhat differently than a typical 
STREAMS driver since a pty driver is not a logical endpoint for the stream. 
After performing the requested flush operation, rather than turning around 
the M_FLUSH message and sending it upstream (or else consuming it), the 
slave (master) driver propogates the message to the read-side of the corre- 
sponding master (slave) device stream. However, a FLUSHR is translated to a 
FLUSHW and vice versa. The master (slave) device driver performs the 

- translated operation before forwarding the message up its stream. The 
stream head for the master (slave) device turns around the M_FLUSH if appro- 
priate. Similarly, ioctl(2) commands such as TCSETAF and TCSETPF which 
require flushing not only flush the slave device stream but also the master 
device stream. 


Slave Read-Side Generated Messages 
Read-side-generated messages defined in streamtty(7) are supported with the 
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following changes: 


All data written to the corresponding master device is sent upstream in 
M_DATA messages from the slave device. 


Closing the corresponding master device is treated as a line disconnect for the 
purposes of generating an M_LHANGUP message (see streamtty(7)). 


M_COPYIN and M_COPYOUT messages are generated in response to a TRANS- 
PARENT M_IOCTL message. 


The following messages are not generated: M_CTL, M_PCCTL. 


Slave Write-Side Received Messages 


Write-side received messages defined in streamtty(7) are supported with the 
following changes: 

All data received in M_DATA messages is sent upstream in M_DATA messages 
from the corresponding master device. 

M_IOCDATA messages are recognized if they apply to a TRANSPARENT ioctl 
being currently performed. 

The TCSBRK M_IOCTL is supported although no break is generated. 

The TIOCGWINSZ and TIOCSWINSZ M_IOCTL is supported in the same man- 
ner as 1d0(7). This replaces the processing 1d0 would do for these ioctls and is 
necessary in order to allow access to the information from the master device 
driver. 

IXOFF and IXON input and output flow control via the MC_STOP, MC_STOPI, 
MC_START, and MC_STARTI forms of the M_LPCCTL message are not sup- 
ported directly by the pty driver. Input flow control is implicitly provided by 
the STREAMS mechanism since there is no hardware device to flow control. 
IXON output flow control via the stop and start characters can still be per- 
formed when the 1d0(7) module is pushed ontop of the slave device driver. 


The following messages are ignored: MLDELAY, M_PCCTL. 


MASTER DEVICE DRIVER 


The master device pty driver is a STREAMS driver which connects with the 
corresponding slave device pty driver. It does not support the termio(7) 
interface. There should be no additional STREAMS modules pushed on top of 
the master device driver. 


Opening a Master Device File 


Typically, a master device is opened via a clone open which selects the next 
available (unused) master device and opens that. The identity of the selected 
master/slave pty pair can be retrieved with a subsequent TIOCPTYDEV ioctl(2) 
call. Ifno unused master device is currently available, the open fails with 
errno set to [EBUSY]. 

Alternately, a particular master device may be explicitly opened. An open of a 
particular master device will fail (with errno set to [EIO]) if that master 
device is currently already open. A master device cannot become a controlling 


terminal; a slave device does this. 


Closing a Master Device File 
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The last process to close the master device will cause the driver close routine 
to be called. If the CLOCAL (c_cflag) mode is not set, an MLHANGUP message 
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will be sent up the slave device stream causing all subsequent access to the 
slave device by an application to fail in the same manner as if modem discon- 
nect had been sensed on a terminal. (See termio(7).) 


Master Read-Side Generated Messages 


M_DATA All data received on the write-side of the corresponding slave 
device is sent upstream in M_DATA messages. 

M_JOCACK Generated in response to any successfully executed M_IOCTL or 
M_PCIOCTL message. 

MLIOCNAK Generated in response to any unsuccessfully executed or 
unrecognized M_IOCTL or M_PCIOCTL message. 

M_FLUSH Generated in response to an M_FLUSH message received on the 
write-side of the corresponding slave device. A FLUSHR is 
translated to a FLUSHW and vice versa from the slave to the 
master side. The master device driver performs the translated 
operation before forwarding the message upstream. 

M_COPYIN 

M_COPYOUT 


Generated in response to a TRANSPARENT M_IOCTL message. 


Master Write-Side Received Messages 


M_DATA 


M_IOCTL 


M_PCIOCTL 


M_IOCDATA 


M_FLUSH 


Master IOCTLS 


The message is passed upstream on the corresponding slave 
device stream. 


The supported ioctl(2) calls are described in the Master IOCTLS 
section below. 


Recognized if it applies to a TRANSPARENT ioctl being currently 
performed. 


If FLUSHW or FLUSHRW is specified, the write queue is flushed. 
The original M_FLUSH message is passed to the corresponding 
slave device driver read-side however a FLUSHR is translated to 
a FLUSHW and vice versa. 


The following ioctl(2) commands are supported as defined in termio(7). 
TIOCPTYDEV M_IOCTL recognized during master write-side processing. 


Returns the major and minor numbers of both the master and 
slave devices. The information is returned as described above. 


Applications should not use this; rather, getpseudotty(3SEQ) 
should be used instead. 


TIOCGWINSZ TRANSPARENT M_IOCTL recognized during master write-side 


processing. Return in struct winsize the current setting of the 
window size of the corresponding slave device. 


TIOCSWINSZ TRANSPARENT M_IOCTL recognized during master write-side 


processing. Sets the window size of the corresponding slave 
device based on the information provided in the struct 
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winsize. If any of the current settings are changed, an M_SIG 
message is sent up the slave device stream to generate a 
SIGWINCH. 


FILES 
/dev/getpty Master pty clone device 
/dev/tty?2/227? Slave pseudo terminals 


SEE ALSO 
getpseudotty(3SEQ), 1d0(7), streamtty(7) 


BUGS 
It is not possible to send an EOT. 
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NAME 


streamtty — Generic STREAMS tty driver interface 


DESCRIPTION - 


This describes a generic interface supported by a STREAMS tty driver that is 
designed to be used in conjunction with the 1d0 tty line discipline STREAMS 
module to implement the terminal interface described in termio(7). This does 
not describe any particular STREAMS tty driver but is rather an interface 
specification to which specific drivers should adhere. A specific driver may 
extend or, in some cases, implement less than what is documented here. Refer 
to the individual manual pages for information about a specific tty driver. 


Terminal State Parameters 


Several ioctl(2) calls described below get and set terminal state parameters as 
defined in termio(7). Note that some ioctls pass these parameters in a ter- 
mio structure while some pass them in a termios structure; the driver is 
responsible for correctly interpreting the ioctl data as the appropriate struc- 
ture. 


Most of the parameters are relevant only to 1d0. The following terminal 
parameters are relevant to the terminal driver. 


The CBAUD (c_cflag ) bits define the baud rate at which the terminal device 
operates. The valid baud rate values are described in termio(7). Unsup- 
ported baud rate changes are ignored. The BO baud rate is interpreted as a 
line disconnect resulting in a hangup operation. 


The CSIZE, CSTOPB, CLOCAL, PARENB, PARODD, and HUPCL (c_cflag ) bits are 
supported if meaningful for the hardware. 


Other parameters, while implemented by 1d0, may also be interpreted by the 
driver in an effort to provide more intelligent or timely behavior as long as 
this behavior adheres to the termio(7) interface. For example: If KON 
(c_ifleg ) is set, the driver could do output flow control (e.g., in hardware) using 
the START and STOP characters defined in the c_cc array rather than relying 
on 1d0 to send M_PCCTL messages requesting the MC_START and MC_STOP 
functions downstream in response to the START and STOP characters; IXANY 
(c_iflag ) could be similarly handled. If CREAD (c_cflag ) is not set, the terminal 
receiver hardware could be disabled rather than relying on 1d0 to silently dis- 
card input in this case. 


Although 1d0 performs the TIOCGWINSZ and TIOCSWINSZ ioctl(2) calls, it 
does so only after the driver has had a chance to perform the ioctl itself. If the 
driver does not perform the ioctl but generates an M_IOCNAK message instead, 
1d0 intercepts the M_IOCNAK and performs the ioctl itself. 


Opening a Terminal Device File 
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When a terminal file is opened, it normally causes the process to wait until a 
connection is established. However, if the CLOCAL (c_cflag ) mode is set in the 
terminal, or if either the O NONBLOCK or the O_NDELAY flag is specified in 
the open(2), then the open will not wait for a connection to be established. 


When a terminal file is opened for the first time (it is not already currently 
open), the driver-internal terminal state parameters are set to the appropriate 
default values as defined in termio(7). 
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A terminal may belong to a process as its controlling terminal. Each process 
of a session that has a controlling terminal has the same controlling terminal. 
A terminal may be the controlling terminal for at most one session. During 
open, a controlling terminal for a session is allocated by the session leader pro- 
cess in the following manner. Ifa session leader has no controlling terminal, 
and opens a terminal device file that is not already associated with a session 
without using the O_NOCTTY open(2) option, the terminal becomes the con- 
trolling terminal of the session leader and the session leader becomes the con- 
trolling process for that terminal. When a controlling terminal becomes asso- 
ciated with a session, its foreground process group is set to the process group 
of the session leader. This will also cause the stream head to use this process 
group as the destination for future signals generated by M_SIG and M_PCSIG 
messages. The session structure has a pointer to a "struct ctty" that is set, if 
the above conditions are met, to "sd_ctty" in the stream head. This should 
only happen for streams to a streamtty device whoes open routine indicates 
that it can become a controlling terminal. 


The typical driver coding sequence is: 


REQ _CTTY(); /* inform stream-head that */ 
/* we can become a ctty */ 


When a controlling process terminates, the controlling terminal is disassoci- 
ated from the current session, allowing it to be re-acquired by a new session 
leader. The exit(2) function does this by zeroing the vnode pointer in the ses- 
sion structure for the process and the session pointer in the stream head. 
Subsequent access to the terminal by other processes in the earlier session are 
denied, with attempts to access the terminal treated at the stream head as if 
modem disconnect had been sensed. The routines ctty_read() and ctty_write() 
will fail because, although the session ID and ctty pointer match, the vnode 
pointer has been zeroed. 


Closing a Terminal Device File 
The last process to close a terminal device file will cause the driver close rou- 
tine to be called. If there is no current active terminal connection, the write 
queue is flushed. If there is a current active terminal connection, then provid- 
ing the driver flags have not been set to O_FNDELAY then the driver will per- 
form an implicit M-PCCTL MC_START message (see below) and wait for any 
output data to finish being sent to the device. The driver will timeout this 
drain to guarantee that the close completes. If the timeout expires before all 
output data has been sent to the device, the remaining output data will be 
flushed. 


Read-side Generated Messages 
M_DATA All input data received from the device is immediately sent 
upstream in M_DATA messages with the exception of framing 
and parity errors which are treated as described below. 


M_CTL The first data byte of the control message indicates the type of 
operation. Additional data bytes may be supplied dependent on 
the operation. Supported operations are: 
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MC_FRAME_ERR A framing error was detected. If the data 
value of the character with the framing error 
is known, it is provided in the remaining data 
bytes of the message. If not supplied, the data 
value of the character is assumed to be zero. 
A break character is represented as a framing 
error character whose data value is zero. 


MC_PARITY_ERR 
A parity error was detected. If the data value 
of the character with the parity error is 
known, it is provided in the remaining data 
bytes of the message. If not supplied, the data 
value of the character is assumed to be zero. 


M_PCCTL The first data byte of the control message indicates the type of 
operation. Additional data bytes may be supplied dependent on 
the operation. Supported operations are: 

MC_STOPI The driver requests that all input data mes- 
sages stop if IXOFF is set. Typically, a 
MC_STOPI message is sent back to the driver. 

M_IOCACK Generated in response to any successfully executed M_IOCTL or 
M_PCIOCTL message. 

M_IOCNAK Generated in response to any unsuccessfully executed or 
unrecognized M_IOCTL or M_PCIOCTL message. 

M_FLUSH Generated in response to either an M_FLUSH message with 
FLUSHR or FLUSHRW set, or a TCSETAF or TCSETPF M_IOCTL 
message. 

M_HANGUP Request the stream head to perform a hangup operation. Gen- 
erated in response to a line disconnect as a result of loss of 
modem control signals while CLOCAL (c_cflag ) is not set. 


Write-side Received Messages 


12/89 


M_DATA The data is delivered to the device for output. 


M_DELAY Request a real-time delay on output. The data buffer contains an 
integer indicating the number of machine ticks of delay. 


M_IOCTL 

M_PCIOCTL 
The ioctl(2) calls described in termio(7) that are supported by the 
tty driver are described in the IOCTLS section below. 


M_PCCTL The first data byte of the priority control message indicates the 
type of operation. Additional data bytes may be supplied depen- 
dent on the operation. Supported operations are: 

MC_STOP Suspend the flow of data from the driver to the 
device. 


MC_START Resume the flow of data from the driver to the 
device. 
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MC_STOPI Suspend the flow of data from the device to the 
driver. The remaining data bytes contain the cur- 
rent STOP character. 


MC_STARTI Resume the flow of data from the device to the 
driver. The remaining data bytes contain the cur- 
rent START character. 


M_FLUSH If FLUSHW or FLUSHRW is specified, the write queue is flushed 
along with all data currently being output to the device (if pos- 
sible). If FLUSHR or FLUSHRW is specified, the driver converts it 
to FLUSHR and sends the M_FLUSH message upstream. 


IOCTLS 
The following ioctl(2) commands are supported as defined in termio(7). 


TCSBRK M_IOCTL recognized during write-side processing. Wait for 
output to drain, then optionally send a break (as described in 
termio(7)). 


TCGETA 

TCGETP M_PCIOCTL recognized during write-side processing. The mes- 
sage should already contain a data buffer sufficiently large to 
contain the necessary returned parameter structure (allocated 
above the stream head). The data buffer is interpreted to be 
the appropriate data structure type, the data structure is 
zeroed, the parameters relevant to driver operation (see above) 
are stored in the data structure, and the message is converted 
to an M_IOCACK message and passed upstream. 


TCSETP 

TCSETPW 

TCSETPF 

TCSETA 

TCSETAW 

TCSETAF Recognized during write-side processing. In the case of TCSETP 
and TCSETA the message is an M_PCIOCTL otherwise the mes- 
sage is an M_IOCTL. In the case of TCSETP or TCSETA an 
M_FLUSH message with FLUSHR set is passed upstream. In all 
cases the parameters relevant to driver operation (see above) 
are internally updated from the values in the data buffer of the 
received message and the message is converted to an 
M_IOCACK message and passed upstream. 


SEE ALSO 
stty(1), close(2), ioctl(2), open(2), 1d0(7), termio(7) 
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NAME 


termio — general terminal interface 


DESCRIPTION 


All of the asynchronous communications ports use the same general interface, 
no matter what hardware is involved. The remainder of this section discusses 
the common features of this interface. 


All simultaneously open files that refer to the same terminal device share a 
common state for that terminal device. The input and output streams for the 
terminal device are shared and the parameters and state described below are 
also shared in common. This means, for example, if one process adjusts the 
parameters that effect input processing, all processes sharing the same termi- 
nal device are affected. 


Opening a Terminal Device File 


When a terminal file is opened, it normally causes the process to wait until a 
connection is established. However, if the CLOCAL mode is set in the termi- 
nal, or if either the O_NONBLOCK or the O_NDELAY flag is specified in the 
open(2), then open will not wait for a connection to be established. In prac- 
tice, users’ programs seldom open terminal files; they are opened by getty and 
become a user’s standard input, output, and error files. 


The Controlling Terminal 


A terminal may belong to a process as its controlling terminal. Each process 
of a session that has a controlling terminal has the same controlling terminal. 
A terminal may be the controlling terminal for at most one session. The con- 
trolling terminal for a session is allocated by the session leader process in the 
following manner. If a session leader has no controlling terminal, and opens a 
terminal device file that is not already associated with a session without using 
the O_NOCTTY open(2) option, the terminal becomes the controlling terminal 
of the session leader and the session leader becomes the controlling process for 
that terminal. When a controlling terminal becomes associated with a ses- 
sion, its foreground process group is set to the process group of the session 
leader. 


The controlling terminal is inherited by a child process during a fork(2). A 
process relinquishes its controlling terminal when it creates a new session 
with the setsid(2) or setpgrp(2) functions, or when all file descriptors associ- 
ated with the controlling terminal have been closed. 


When a controlling process terminates, the controlling terminal is disassoci- 
ated from the current session, allowing it to be reacquired by a new session 
leader. Subsequent access to the terminal by other processes in the earlier 
session may be subsequently denied, with attempts to access the terminal 
treated as if modem disconnect had been sensed. 


Process Groups 


Aterminal may have a foreground process group associated with it. This fore- 
ground process group plays a special role in handling signal-generating input 
characters, as discussed below. Also, command interpreter processes support- 
ing job control can allocate the terminal to different jobs , or process groups, by 
placing related processes in a single process group and associating this process 
group with the terminal. The terminal interface aids in the allocation by 
restricting access to the terminal by processes that are not in the current 
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foreground process group. This is accomplished in the following way: 


Terminal Access Control 
Attempts by a process in a background process group to read from its control- 
ling terminal cause its process group to be sent a SIGTTIN signal unless one of 
the following special cases apply: If the reading process is ignoring or blocking 
the SIGTTIN signal, or if the process group of the reading process is orphaned, 
the read(2) returns —1 with errno set to [EIO] and no signal is sent. The 
default action of the SIGTTIN signal is to stop the process to which it is sent. 


Attempts by a process in a background process group to write to its controlling 
terminal cause its process group to be sent a SIGTTOU signal unless one of the 
following special cases apply: If TOSTOP (see the discussion of c_Iflag below) is 
not set, or if TOSTOP is set and the process is ignoring or blocking the 
SIGTTOU signal, then the process is allowed to write to the terminal and the 
SIGTTOU signal is not sent. If TOSTOP is set, and the process group of the 
writing process is orphaned, and the writing process is not ignoring or block- 
ing SIGTTOU, the write(2) returns —1 with errno set to [EIO] and no signal is 
sent. 


Certain ioctl() calls that set terminal parameters are treated in the same 
fashion as write, except that TOSTOP is ignored; that is, the effect is identical 
to that of terminal writes when TOSTOP is set. 


Input Processing and Reading Data 
Aterminal associated with one of these files ordinarily operates in full-duplex 
mode. Characters may be typed at any time, even while output is occurring, 
and are only lost when the system’s character input buffers become completely 
full, which is rare, or when the user has accumulated the maximum allowed 
number of input characters that have not yet been read by some program. 
Currently, this limit is at least 256 characters. When the input limit is 
reached, the buffer is flushed and all the saved characters are thrown away 
without notice. 


Two general kinds of input processing are available, determined by whether 
the terminal device file is in canonical mode (ICANON set) or non-canonical 
mode. Additionally, input characters are processed according to the c_iflag 
and c_Iflag fields. Such processing can include echoing, which means that 
input characters are put in the output queue as they arrive. This is useful for 
terminals that can operate in full-duplex mode. 


Also the setting of the O NONBLOCK and O_NDELAY flags via open(2) or 
fentl(2) affect the operation of read(2). See the discussion of these flags for 
STREAMS devices in read(2). With respect to that discussion, note that when 
data is available depends on whether the input processing mode is canonical 
or non-canonical. 


Canonical Mode Input Processing 
In canonical mode, terminal input is processed in units of lines. A line is del- _ 
imited by a new-line (NL) character, an end-of-file (EOF) character, or an 
end-of-line (EOL) character. This means that a program attempting to read 
will be suspended until an entire line has been typed. Also, no matter how 
many characters are requested in the read call, at most one line will be 
returned. It is not, however, necessary to read a whole line at once; any num- 
ber of characters may be requested in a read, even one, without losing 
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information. 


Erase and kill processing occur when either of the two special characters, 
ERASE and KILL, is received. The ERASE character erases the last character 
typed, except that it will not erase beyond the beginning of the line. The KILL 
character kills (deletes) the entire input line, and optionally outputs a new- 
line character. Both these characters operate on a key-stroke basis, indepen- 
dently of any backspacing or tabbing that may have been done. Under some 
modes (see IEXTEN), the ERASE, KILL, and EOF characters may be entered lit- 
erally by preceding them with the escape character (\). In this case the 
escape character is not read. 


Non-Canonical Mode Input Processing 


In non-canonical mode input processing, input characters are not assembled 
into lines, and erase and kill processing does not occur. The values of the MIN 
and TIME members of the c_cc array are used to determine how to process the 
characters received. 


MIN represents the minimum number of characters that should be received 
when the read() successfully returns. TIME is a timer of 0.1 second granular- 
ity that is used to timeout burst and short-term data transmissions. The four 
possible values for MIN and TIME and their interactions are described below. 


Case A: MIN > 0, TIME > 0 


In this case TIME serves as an intercharacter timer and is activated after the 
first character is received. Since it is an intercharacter timer, it is reset after 
a character is received. The interaction between MIN and TIME is as follows: 
as soon as one character is received, the intercharacter timer is started. If 
MIN characters are received before the intercharacter timer expires (remem- 
ber that the timer is reset upon receipt of each character), the read is satis- 
fied. If the timer expires before MIN characters are received, the characters 
received to that point are returned to the user. Note that if TIME expires, at 
least one character will be returned because the timer would not have been 
enabled unless a character was received. In this case (MIN > 0, TIME > 0) the 
read will block until the MIN and TIME mechanisms are activated by the 
receipt of the first character, or a signal is received. 


Case B: MIN > 0, TIME = 0 


In this case, since the value of TIME is zero, the timer plays no role and only 
MIN is significant. A pending read is not satisfied until at least MIN charac- 
ters are received (the pending read will block until at least MIN characters are 
received), or a signal is received. A program that uses this case to read record- 
based terminal I/O may block indefinitely in the read operation. 


Case C: MIN = 0, TIME > 0 


In this case, since the value of MIN is zero, TIME no longer represents an inter- 
character timer. It now serves as a read timer that is activated as soon as a 
read() is processed. A read is satisfied as soon as a single character is 
received or the read timer expires. Note that in this case if the timer expires, 
no characters will be returned. If the timer does not expire, the only way the 
read can be satisfied is if a character is received. In this case the read will not 
block indefinitely waiting for a character; if no character is received within 
TIME*0.1 seconds after the read is initiated, the read() will return a value of 
zero, having read no data. 
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Case D: MIN = 0, TIME = 0 
The minimum of either the number of characters requested or the number of 
characters currently available will be returned without waiting for more char- 
acters to be input. Ifno characters are available, read() will return a value of 
zero, having read no data. In this case, the read() never blocks, return is 
immediate. 

Writing Data and Output Processing 
When one or more characters are written, they are processed according to the 
c_oflag field and then transmitted to the terminal as soon as previously-writ- 
ten characters have finished typing. If a process produces characters more 
rapidly than they can be typed, it will be suspended when its output queue 
exceeds some limit. When the queue has drained down to some threshold, the 
program is resumed. 


Also the setting of the O NONBLOCK and O_NDELAY flags via open(2) or 
fentl(2) affect the operation of write(2). See the discussion of these flags for 
STREAMS devices in write(2). 


Special Characters 
Certain characters have special functions on input. These functions and their 
default character values are summarized as follows: 


INTR  (Rubout or ASCII DEL) If ISIG is set, generates an interrupt signal 
(SIGINT) which is sent to all processes in the foreground process 
group associated with the terminal. Normally, each such process is 
forced to terminate, but arrangements may be made either to ignore 
the signal or to receive a trap to an agreed-upon location; see sig- 
nal(2). If NOFLSH is not set, the input and output queues are flushed 
when the signal is sent. If ISIG is set, the INTR character is discarded 
when processed. 


QUIT (Control-| or ASCII FS) If ISIG is set, generates a quit signal 
(SIGQUIT). Its treatment is identical to the interrupt signal except 
that, unless a receiving process has made other arrangements, it will 
not only be terminated but a core image file (called core) will be 
created in the current working directory. If NOFLSH is not set, the 
input and output queues are flushed when the signal is sent. If ISIG 
is set, the QUIT character is discarded when processed. 


SUSP  (Control-z or ASCII SUB) If ISIG is set, generates a terminal stop sig- 
nal (SIGTSTP) which is sent to all processes in the foreground process 
group associated with the terminal. Normally, each such process is 
forced to suspend, but arrangements may be made either to ignore 
the signal or to receive a trap to an agreed-upon location; see sig- 
nal(2). If NOFLSH is not set, the input and output queues are flushed 
when the signal is sent. If ISIG is set, the SUSP character is dis- 
carded when processed. 


ERASE (#) IFICANON is set, erases the preceding input character. It will not 
erase beyond the start of a line, as delimited by a NL, EOF, or EOL 
character. If ICANON is set, the ERASE character is discarded when 
processed. 


KILL (@) IfICANON is set, deletes the entire line, as delimited by a NL, 
EOF, or EOL character. If ICANON is set, the KILL character is 
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discarded when processed. 


S EOF (Control-d or ASCII EOT) If ICANON is set, may be used to generate an 
end-of-file from a terminal. When received, all the characters wait- 
ing to be read are immediately passed to the program, without wait- 
ing for a new-line, and the EOF is discarded. Thus, if there are no 
characters waiting, which is to say the EOF occurred at the beginning 
of a line, zero characters will be passed back, which is the standard 
end-of-file indication. 


NL (ASCII LF) is the normal line delimiter recognized if ICANON is set. It 
can not be changed. 


EOL (ASCII NUL) is an additional line delimiter, like NL. It is not nor- 
mally used. 


EOL2 (ASCII NUL) is another additional line delimiter. 


STOP  (Control-s or ASCII DC3) If the IXON flag is set, can be used to tempo- 
rarily suspend output. It is useful with CRT terminals to prevent out- 
put from disappearing before it can be read. If the IXON flag is set, 
the STOP character is discarded when processed. While output is 
suspended, STOP characters are ignored and discarded. Also used for 
input flow control if the [XOFF flag is set. 


START (Control-q or ASCII DC1) If the [XON flag is set, is used to resume out- 
put which has been suspended by a STOP character. If the IXON flag 
is set, the START character is discarded when processed. While out- 
put is not suspended, START characters are ignored and discarded. 

& Also used for input flow control if the IXOFF flag is set. 


CR (ASCII CR) the carriage return character. It can not be changed. 


The character values for INTR, QUIT, SUSP, ERASE, KILL, EOF, EOL, EOL2, 
START, and STOP may be changed to suit individual tastes. Under some 
modes (see IEXTEN), the ERASE, KILL, and EOF characters may be escaped by 
a preceding \ character, in which case no special function is done. 


If two or more special characters have the same value, the function performed 
when that character is received is undefined. 


Modem Disconnect 
If a modem disconnect is detected by the terminal interface for a controlling 
terminal, and if CLOCAL is not set for the terminal, the hang-up signal 
(SIGHUP) is sent to the controlling process associated with the terminal. 
Unless other arrangements have been made, this causes the controlling pro- 
cess to terminate. Any subsequent read from the terminal device by any pro- 
cess returns with an end-of-file indications until the device is closed. Thus, 
processes that read a terminal file and test for end-of-file can terminate appro- 
priately after a disconnect. Any subsequent write to the terminal device 
returns —1, with errno set to [EIO], until the device is closed. 

Closing a Terminal Device File 
The last process to close a terminal device file will cause any output to be sent 
to the device and any input to be discarded. Then, if HUPCL is set, and the 

2 communications port supports a disconnect function, the terminal device shall 

perform a disconnect. 
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Terminal Parameters 
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Several ioct](2) system calls apply to terminal files. Some of the calls use a 
structure which represents a collection of terminal state parameters. The 
structure is used to retrieve and to set terminal parameters. It should be 
noted that it is the invoking of the ioc#l() calls, and not merely storing values 
into the structure, which affects the actual terminal state. There are two 
slightly different versions of the terminal state structure namely termios and 
termio and a third, obsolescent version, sgttyb that are used. 


Termio and termios Terminal Parameters 
The primary calls use the termios structure, defined in <termios.h>: 


struct termios { 
teflag_t 
teflag_t 
teflag_t 
tcflag t 
eet 


Ye 


c_iflag; 
c_oflag; 
c_cflag; 
c_lflag; 
¢_cc[NCCS]; 


/* 
/* 
/* 
/* 
/* 


input modes */ 
output modes */ 
control modes */ 
local modes */ 
control chars */ 


The special control characters are defined by the array c_cc. The relative 
positions and initial values for each function are as follows: 


VINTR 
VQUIT 
VERASE 
VKILL 

VEOF / VMIN 
VEOL / VTIME 
VEOL2 
reserved 
VSTART 
VSTOP 

10 VSUSP 
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o 


DEL 
FS 


Dc3 
SUB 


The operating system termio structure is used by other ioctl(2) system calls; 


it is defined in <termio.h>: 


#define Nncc 

struct termio { 
unsigned 
unsigned 
unsigned 
unsigned 
char 
unsigned 

Ye 
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short c_iflag; 
short c_oflag; 
short c_cflag; 
short c_lflag; 


c_line; 


/* 
/* 
/* 
/* 
/* 


char c_cc[Ncc]; /* 


input modes */ 
output modes */ 
control modes */ 
local modes */ 
line-discipline */ 
control chars */ 


The special control characters are defined by the array c_cc. The relative 
positions and initial values for each function are as follows: 


QO VINTR 


DEL 
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VQUIT FS 
VERASE # 
VKILL @ 


VEOF / VMIN EOT 
VEOL / VTIME NUL 
VEOL2 NUL 
7 reserved 


The calls that use the termio structure only affect the flags and control char- 
acters that can be stored in the termio structure; all other flags and control 
characters are unaffected. 
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Input Modes 


The c_iflag field describes the basic terminal input control: 


IGNBRK 0000001 Ignore break condition. 

BRKINT 0000002 Signal interrupt on break. 

IGNPAR 0000004 Ignore characters with parity errors. 
PARMRK 0000010 Mark parity errors. 


INPCK 0000020 Enable input parity check. 

ISTRIP 0000040 Strip character. 

INLCR 0000100 Map NL to CR on input. 

IGNCR 0000200 Ignore cR. 

ICRNL 0000400 Map CR to NL on input. 

IUCLC 0001000 Map uppercase to lowercase on input. 
IXON 0002000 Enable start/stop output control. 

IXANY 0004000 Enable any character to restart output. 
IXOFF 0010000 Enable start/stop input control. 


If IGNBRK is set, the break condition (a character framing error with data all 
zeros) is ignored, that is, not put on the input queue and therefore not read by 
any process. If IGNBRK is not set and BRKINT is set, the break condition will 
generate an interrupt signal and flush both the input and output queues. If 
IGNPAR is set, characters with framing and parity errors (other than break) 
are ignored. 


If PARMRK is set, a character with a framing or parity error (other than break) 
which is not ignored is read as the three-character sequence: ’\377’, ’\0’, X, 
where X is the data of the character received in error. To avoid ambiguity in 
this case, if ISTRIP is not set, a valid character of ’\377’ is read as ’\377’, 
\377’. If PARMRK is not set, a framing or parity error (other than break) 
which is not ignored is read as the character NUL (\0?). 

If INPCK is set, input parity checking is enabled. If INPCK is not set, input 
parity checking is disabled. This allows output parity generation without 
input parity errors. Note that whether input parity checking is enabled or 
disabled is independent of whether parity detection (PARENB) is enabled or 
disabled. If parity detection is enabled (PARENB set) but parity checking is 
disabled (INPCK not set), the hardware to which the terminal is connected will 
recognize the parity bit, but the terminal special file will not check whether 
this bit is set correctly or not. 

If ISTRIP is set, valid input characters are first stripped to 7 bits, otherwise all 
8 bits are processed. 
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If INLCR is set, a received NL character is translated into a CR character. If 
IGNCR is set, a received CR character is ignored (not read). If IGNCR is not set 
and ICRNL is set, a received CR character is translated into a NL character. 


IfIUCLC is set, a received uppercase alphabetic character is translated into 
the corresponding lowercase character. 


If IXON is set, start/stop output control is enabled. A received STOP character 
will suspend output and a received START character will restart output. 

When IXON is set, START and STOP characters are not read, but merely per- 
form flow control functions. When IXON is not set, the START and STOP char- 
acters are read. If IXANY is set, any input character, will restart output which 
has been suspended and, if it is neither the start nor stop character, the char- 
acter will still be read. 


If IXOFF is set, the system will transmit START/STOP characters when the 
input queue is nearly empty/full. 


The initial input control value is all-bits-clear except the console which has 
ICRNL, IXON, IXOFF, BRKINT and IGNPAR set. 


Output Modes 
The c_oflag field specifies the system treatment of output: 


OPOST 0000001 Postprocess output. 
OLcuc 0000002 Map lower case to upper on output. 
ONLCR 0000004 Map NL to CR-NL on output. 
OCRNL 0000010 Map CR to NL on output. 
ONOCR 0000020 No cr output at column 0. 
ONLRET 0000040 NL performs cR function. 
OFILL 0000100 Use fill characters for delay. 
OFDEL 0000200 Fill is DEL, else NUL. 
NLDLY 0000400 Select new-line delays: 
NLO 0 
NL1 0000400 
CRDLY 0003000 Select carriage-return delays: 
CRO 0 
CR1 0001000 
CR2 0002000 
CR3 0003000 
TABDLY 0014000 Select horizontal-tab delays: 
TABO ie} 
TAB1 0004000 
TAB2 0010000 
TAB3 0014000 Expand tabs to spaces. 
BSDLY 0020000 Select backspace delays: 
BSO 0 
BS1 0020000 
VTDLY 0040000 Select vertical-tab delays: 
vTO 0 
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VTl 0040000 

FFDLY 0100000 Select form-feed delays: 
FFO 0 
FF1 0100000 


If OPOST is set, output characters are post-processed as indicated by the 
remaining flags, otherwise characters are transmitted without change. 


If OLCUC is set, a lowercase alphabetic character is transmitted as the corre- 
sponding uppercase character. This function is often used in conjunction with 
TUCLC 


If ONLCR is set, the NL character is transmitted as the CR-NL character pair. 
If OCRNL is set, the CR character is transmitted as the NL character. If 
ONOCR is set, no CR character is transmitted when at column 0 (first position). 
If ONLRET is set, the NL character is assumed to do the carriage-return func- 
tion; the column pointer will be set to 0 and the delays specified for CR will be 
used. Otherwise the NL character is assumed to do just the line-feed function; 
the column pointer will remain unchanged. The column pointer is also set to 0 
if the CR character is actually transmitted. 


The delay bits specify how long transmission stops to allow for mechanical or 
other movement when certain characters are sent to the terminal. In all cases 
a value of 0 indicates no delay. If OFILL is set, fill characters will be transmit- 
ted for delay instead of a timed delay. This is useful for high baud rate termi- 
nals which need only a minimal delay. If OFDEL is set, the fill character is 
DEL (\177), otherwise NUL. 


If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 
New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage-return 
delays are used instead of the new-line delays. If OFILL is set, two fill charac- 
ters will be transmitted. 

Carriage-return delay type 1 is dependent on the current column position, 


type 2 is about 0.10 seconds, and type 3 is about 0.15 seconds. If OFILL is set, 
delay type 1 transmits two fill characters, and type 2, four fill characters. 


Horizontal-tab delay type 1 is dependent on the current column position. 
Type 2 is about 0.10 seconds. Type 3 specifies that tabs are to be expanded 
into spaces. If OFILL is set, two fill characters will be transmitted for any 


delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character 
will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear except the console which has 
OPOST, ONLCR and TAB3 set. 


Control Modes 


The c_cflag field describes the hardware control of the terminal: 
CBAUD 0000017 Baud rate: 
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BO 0 Hang up 
B50 0000001 50 baud 
B75 0000002 75 baud 
B110 0000003 110 baud 
B134 0000004 134 baud 
B150 0000005 150 baud 
B200 0000006 200 baud 
B300 0000007 300 baud 
B600 0000010 600 baud 


B1200 0000011 1200 baud 
B1800 0000012 1800 baud 
B2400 0000013 2400 baud 
B4800 0000014 4800 baud 
B9600 0000015 9600 baud 
B19200 0000016 19200 baud 


EXTA 0000016 External A 

B38400 0000017 38400 baud 

EXTB 0000017 External B 
CSIZE 0000060 Character size: 

css 0 5 bits 

CS6 0000020 6 bits 

cs7 0000040 7 bits 

cs8 0000060 8 bits 
CSTOPB 0000100 Send two stop bits, else one. 
CREAD 0000200 Enable receiver. 


PARENB 0000400 Parity enable. 
PARODD 0001000 Odd parity, else even. 


HUPCL 0002000 Hang up on last close. 
CLOCAL 0004000 Local line, else dial-up. 
RCV1EN 0010000 reserved 

XMT1EN 0020000 reserved 

LOBLK 0040000 reserved 


The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang 
up the connection. If BO is specified, the data-terminal-ready signal will not 
be asserted. Normally, this will disconnect the line. For any particular hard- 
ware, impossible speed changes are ignored. When directly manipulating the 
CBAUD bits in the c_cflag field, setting only one baud rate is possible which is 
interpreted to be both the input and output baud rate. 


The following POSIX-conforming interfaces are also provided for getting and 
setting the values of the input and output baud rates in the termios struc- 
ture. The effects on the terminal device do not become effective until the 
tesetattr() function is successfully called. 


#include <termios.h> 


speed_t cfgetospeed (termios_p) 
struct termios *termios_p; 


int cfsetospeed (termios p, speed) 
struct termios *termios p; 


speed _t speed; 
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speed _t cfgetispeed (termios_p) 
struct termios *termios_p; 


int cfsetispeed (termios_p, speed) 

struct termios *fermios_p; 

speed _t speed; 
The type speed_t is defined in <termios.h> and is an unsigned integral type. 
It can assume any value defined above for the CBAUD bits. 
The termios_p argument is a pointer to a termios structure. Note that use of 
a termio structure is unsupported with these POSIX-conforming interfaces. 


cfgetospeed() returns the output baud rate stored in the termios structure 
pointed to by termios_p. 

cfsetospeed() sets the output baud rate stored in the termios structure 
pointed to by termios_p to speed. The zero baud rate, BO, is used to terminate 
the connection. If Bo is specified, the modem control lines will no longer be 
asserted. Normally, this will disconnect the line. 


efgetispeed() returns the input baud rate stored in the termios structure. 


cfsetispeed() sets the input baud rate stored in the termios structure to 
speed. If the input baud rate is set to zero, the input baud rate will be speci- 
fied by the value of the output baud rate. Both cfsetispeed() and 
cfsetospeed() return a value of zero if successful and —1 to indicate an error. 
Attempts to set unsupported baud rates are ignored and no error is returned. 
This refers both to changes to baud rates not supported by the hardware, and 
to changes setting the input and output baud rates to different values if the 
hardware does not support this. 

The CSIZE bits specify the character size in bits for both transmission and 
reception. This size does not include the parity bit, ifany. If CSTOPB is set, 
two stop bits are used, otherwise one stop bit. For example, at 110 baud, two 
stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a parity bit is 
added to each character. If parity is enabled, the PARODD flag specifies odd 
parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will be 
received. 

If HUPCL is set, the line will be disconnected when the last process with the 
line open closes it or terminates. That is, the data-terminal-ready signal will 
not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection with no 
modem control. Otherwise modem control is assumed. 

Under normal circumstances, a call to open(2) will wait for the modem con- 
nection to complete. However, if the CLOCAL mode is set in the terminal, or if 
either the O_NONBLOCK or the O_NDELAY flag is specified in the open(2), then 
open will not wait for a connection to be established. 


The initial hardware control value after open is B300, CS8, CREAD, HUPCL. 
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Local Modes 
The c_Iflag field of the argument structure is used by the line discipline to con- 
trol terminal functions. The basic line discipline ( c_line set to zero) provides 
the following: 


ISIG 0000001 Enable signals. 

ICANON 0000002 Canonical input (erase and kill processing). 
XCASE 0000004 Canonical upper/lower presentation. 

ECHO 0000010 Enable echo. 

ECHOE 0000020 Echo erase character as BS-SP-BS. 

ECHOK 0000040 Echo NL after kill character. 

ECHONL 0000100 Echo NL. 

NOFLSH 0000200 Disable flush after interrupt, quit, or suspend. 
tostop 0000400 Send sicttou signal for background output. 

IEXTEN 0200000 Enable extended functions. 


If ISIG is set, each input character is checked against the special control char- 
acters INTR, QUIT, and SUSP. If an input character matches one of these con- 
trol characters, the function associated with that character is performed. If 
ISIG is not set, no checking is done. Thus these special input functions are 
possible only if ISIG is set. These functions may be disabled individually by 
changing the value of the control character to an unlikely or impossible value 
(e.g., \377). 


If ICANON is set, canonical processing is enabled. This enables the erase and 
kill edit functions, and the assembly of input characters into lines delimited by 
NL, EOF, EOL, and, if IEXTEN is set, EOL2. See the Canonical Mode Input Pro- 
cessing section above for more details. If ICANON is not set, read requests are 
satisfied directly from the input queue. A read will not be satisfied until at 
least MIN characters have been received or the timeout value TIME has 
expired between characters. This allows fast bursts of input to be read effi- 
ciently while stil] allowing single character input. The MIN and TIME values 
are stored in the position for the EOF and EOL characters, respectively. (These 
positions may also be referenced as VMIN and VTIME, respectively.) The time 
value represents tenths of seconds. See the Non-Canonical Mode Input Pro- 
cessing section above for more details. 


If XCASE is set, and if ICANON is set, an uppercase letter is accepted on input 
by preceding it with a \ character, and is output preceded by a \ character. In 
this mode, the following escape sequences are generated on output and 
accepted on input: 


for: use: 
. V 
I Ml 
a No 
{ XC 
} AY) 
\ \ 


For example, A is input as \a, \n as \\n, and \N as \\\n. 


If ECHO is set, characters are echoed as received. 
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When ICANON is set, the following echo functions are possible: If ECHO and 
ECHOE are set, when the ERASE character is processed it is echoed as ASCII 
BS SP BS if there is an input character to erase, which will clear the last char- 
acter from a CRT screen. If ECHOE is set and ECHO is not set, when the ERASE 
character is processed it is echoed as ASCII SP BS. If ECHOK is set, the NL 
character will be echoed after the KILL character to emphasize that the line 
will be deleted. If ECHONL is set, the NL character will be echoed even if 
ECHO is not set. This is useful for terminals set to local echo (so-called half 
duplex). When processed, the EOF character is not echoed. Because EOT is 
the default EOF character, this prevents terminals that respond to EOT from 
hanging up. 

If NOFLSH is set, the normal flush of the input and output queues associated 
with the quit, interrupt, and suspend characters will not be done. 


If TOSTOP is set, the SIGTTOU signal is sent to the process group of a process 
that tries to write to its controlling terminal if it is not in the foreground pro- 
cess group for that terminal. This signal, by default, stops the members of the 
process group. If TOSTOP is not set, or if the process writing to its controlling 
terminal is blocking or ignoring SIGTTOU signals, the output is allowed and 
the SIGTTOU signal is not sent. See the Terminal Access Control section 
above for more details. 


IEXTEN is supported only for functions using the termios structure. Func- 
tions using the termio structure behave as if EXTEN were set. If IEXTEN is 
set, the following extensions to the POSIX-compatible terminal interface are 
honored: XCASE in c_Iflag , TUCLC and IXANY in c_iflag , the EOL2 special char- 
acter, and escaping of the ERASE, KILL, and EOF special characters. If IEXTEN 
is not set, the POSIX-compatible terminal interface is strictly adhered to and 
the functional extensions listed above are disabled. 


The initial line-discipline control value is the IEXTEN bit set and all other bits 
clear except the console which has in addition ISIG, ICANON, ECHO and 
ECHOK set. 

The initial line-discipline selector value, c_line is zero. If an attempt is made 
to change c_line from this value, [EINVAL], is returned. 


Sgttyb Terminal Parameters 


The third, obsolescent version of the terminal state structure is struct sgttyb 
defined in <ttold.h>: 


struct sgttyb { 


char sg_ispeed; 
char sg_ospeed; 
char sg_erase; 
char sg_kill; 
char sg_flags; 


le 
The functions stty(3) and gtty(3) use this structure as an argument which in 
turn is converted into an ioctl() TIOCSETP and TIOCGETP respectively. 
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The sg_flags field describes the terminal control: 


O_HUPCL 0000001 Hang up on last close. 

O_XTABS 0000002 Expand tabs to spaces on output. 
O_LCASE 0000004 Canonical upper/lower presentation. 
O_ECHO 0000010 Enable echo. 

O_CRMOD 0000020 Canonical cR to NL mapping. 

O_RAW 0000040 Canonical input processing. 

O_ODDP 0000100 Odd parity, or with O_EVENP no parity. 
O_EVENP 0000200 Even parity, or with O_ODD no parity 
O_NLDELAY 0001400 Select new-line delays: 

O_NL1 0000400 Termio cR1 delay if O_CRMOD set.) 
O_NL2 0001000 Termio cR2 delay if O_CRMOD set. 
O_TBDELAY 0002000 Select horizontal-tab delays. 

O_NOAL 0004000 Echo NL after kill character. 
O_CRDELAY 0030000 Select carriage-return delays: 

© _CR1 0010000 Termio cR1l delay. 

O_CR2 0020000 Termio cR2 delay. 


O_VTDELAY 0040000 Select vertical-tab delays. 
O_BSDELAY 0100000 Select backspace delays. 


IOCTLS 
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The ioctl() calls supported are listed below. Note that some calls operate on a 
termios structure while others operate on a termio structure. Some calls 
may not be supported by all devices or modules. 


Unless otherwise noted for a specific ioctl() call, these functions are restricted 
from use by processes belonging to a background process group. Attempts to 
perform these operations shall cause the process group to be sent a SIGTTOU 
signal. If the calling process is blocking or ignoring SIGTTOU signals, the pro- 
cess is allowed to perform the operation and the SIGTTOU signal is not sent. 
See the Terminal Access Control section above for more details. 


The terminal ioct](2) system calls have the form: 


#include <sys/types.h> 
#include <termio.h> or #include <termios.h> 


int ioctl (fildes, command, arg) 
In all the calls, fildes is an open file descriptor. (However, the calls affect the 
underlying terminal file, and not just the open file description associated with 
the file descriptor.) arg is of different types depending on the command. Upon 
successful completion, the ioctl() will return a value of zero. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. The following 
errno values may be returned by any of the commands: 


[EBADF] The fildes argument is not a valid file descriptor. 
[EINVAL] Either arg or the data it references is not a proper 
value. 


[ENOTTY] The file associated with fildes is not a terminal. 


In addition to these, each command may use additional errno values unique to 
the specific command; these are described below. 
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The commands are: 


TCGETP 


TCSETP 


TCSETPW 
TCSETPF 


TCGETA 


TCSETA 


TCSETAW 
TCSETAF 
TCSBRK 


TCXONC 


TCFLSH 


TIOCGPGRP 


Get the parameters associated with the terminal and store in 
the termios structure referenced by arg. Only those parame- 
ters that can be stored in the termios structure are returned. 
This command is allowed from a process in a background pro- 
cess group; however, the terminal attributes may be subse- 
quently changed by a process in the foreground process group. 


Set the parameters associated with the terminal from the ter- 
mios structure referenced by arg. Only those terminal param- 
eters that can be stored in the termios structure are set. The 
change is immediate. 


Same as TCSETP except that it first waits for the output to 
drain before setting the new parameters. This form should be 
used when changing parameters that will affect output. 


Same as TCSETP except that it first waits for the output to 
drain and then flushes the input queue before setting the new 
parameters. 


Get the parameters associated with the terminal and store in 
the termio structure referenced by arg. Only those parame- 
ters that can be stored in the termio structure are returned. 
This command is allowed from a process in a background pro- 
cess group; however, the terminal attributes may be subse- 
quently changed by a process in the foreground process group. 


Set the parameters associated with the terminal from the ter- 
mio structure referenced by arg. Only those terminal parame- 
ters that can be stored in the termio structure are set with the 
exception of IEXTEN which is forced to be set. The change is 
immediate. 


Same as TCSETA except that it first waits for the output to 
drain before setting the new parameters. This form should be 
used when changing parameters that will affect output. 


Same as TCSETA except that it first waits for the output to 
drain and then flushes the input queue before setting the new 
parameters. 


Wait for the output to drain. If arg (an int value) is 0, then 
send a break (zero bits for 0.25 seconds). 

Start/stop control. Ifarg (an int value) is 0, suspend output; if 
1, restart suspended output; if 2, send a STOP character to the 
terminal device; if 3, send a START character to the terminal 
device. 

If arg (an int value) is 0, flush the input queue; if 1, flush the 
output queue; if 2, flush both the input and output queues. 


Get the process group ID of the foreground process group asso- 
ciated with the terminal and store in the pid_t referenced by 
arg. If the terminal referenced by fildes is not the controlling 
terminal of the calling process, the ioctl() returns —1 with 
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errno set to [ENOTTY]. If the lifetime of the current fore- 
ground process group has ended, the ioctl() returns —1 with 
errno set to [EACCES]. This command is allowed from a pro- 
cess in a background process group; however, the information 
may be subsequently changed by a process in the foreground 
process group. 

TIOCSPGRP __ Set the foreground process group ID associated with the termi- 
nal from the process group ID stored in the pid_t referenced by 
arg. If the terminal referenced by fildes is not the controlling 
terminal of the calling process and is not also still associated 
with the session of the calling process, the ioctl() returns —1 
with errno set to [ENOTTY]. If the new process group ID value 
does not match the process group ID of a process in the same 
session as the calling process, the ioctl() returns —1 with errno 
set to [EPERM]. 


TIOCGWINSZ Get the current winsize structure settings. struct winsize is 
defined in <termio.h>. 


TIOCSWINSZ Set the current winsize structure. If any of values differ from 
their previous values then SIGWINCH is generated. 


TIOCGETP Get the parameters associated with the terminal, and store it 
in the sgttyb structure referenced by arg. This ioctl() is obso- 
lete and tegetaddr() should be used instead. 


TIOCSETP Set the parameters associated with the terminal from the 
sgttyb structure referenced by arg. The interface delays until 
output is quiescent, then throws away any unread characters, 
before changing the modes. This ioctl() is obsolete and 
tesetaddr() should be used instead. 


The following POSIX-conforming interfaces are also provided for performing 
some of the ioctl() command functions. Unless otherwise indicated, their 
return value and errno values are identical to the indicated ioctl() functions 
they perform. 

#include <termios.h> 


int tcgetattr (fildes, termios_p) 
int fildes; 
struct termios *lermios_p; 
The tegetattr() function performs the TCGETP command. 


#include <termios.h> 


int tcsetattr (fildes, optional_actions, termios_p) 

int fildes, optional_actions; 

struct termios *termios_p; 
If optional_actions is TCSANOW, the function performs the TCSETP command. 
If optional_actions is TCSADRAIN, the function performs the TCSETPW com- 
mand. If optional_actions is TCSAFLUSH, the function performs the TCSETPF 
command. 
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#include <termios.h> 


int tcsendbreak (fildes, duration) 
int fildes; 
int duration; 
The tcesendbreak() function performs the TCSBRK command with an arg of 0. 


#include <termios.h> 


int tcdrain (fildes) 
int fildes; 


The tedrain() function performs the TCSBRK command with an arg of 1. 


#include <termios.h> 


int tcflush (fildes, queue_selector) 

int fildes; 

int queue_selector ; 
If queue_selector is TCIFLUSH, the function performs the TCFLSH command 
with an arg of 0. If queue_selector is TCOFLUSH, the function performs the 
TCFLSH command with an arg of 1. If queue_selector is TCIOFLUSH, the func- 
tion performs the TCFLSH command with an arg of 2. 


#include <termios.h> 


int tcflow (fildes, action) 

int fildes; 

int action; 
If action is TCOOFF the function performs the TCXONC command with an arg 
of 0. If action is TCOON, the function performs the TCXONC command with an 
arg of 1. If action is TCIOFF, the function performs the TCXONC command with 
an arg of 2. If action is TCION, the function performs the TCXONC command 
with an arg of 3. 


#include <sys/types.h> 


pid_t tcgetpgrp (fildes) 

int fildes; 
The tcgetpgrp() function performs the TIOCGPGRP command. The foreground 
process group ID is returned as the value of the tcgetpgrp() function. 


#include <sys/types.h> 


int tcesetpgrp (fildes, pgrp_id) 

int fildes; 

pid_t pgrp_id; 
The tcsetpgrp() function performs the TIOCSPGRP command. Note that 
pgrp_id contains the value of the new process group ID while arg for 
TIOCSPGRP contains a pointer to the value of the new process group ID. 
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FILES 
/devitty* 
SEE ALSO 
atty(1), fork(2), ioctl(2), setpgrp(2), signal(2) 
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NAME 


tg — SCSI 1/2-inch magnetic tape interface 


CONFIGURATION ENTRY 


tg on ssm_scsi ssm_scsi unit unit segsize 32768 nsegs 1 


DESCRIPTION 


This device driver supports SCSI target adapters for 1/2-inch magnetic tape 
drives. All functionality as described in mtio(7) is supported, except where 
noted. Up to eight tape drive units spread across the SSM boards in the sys- 
tem are supported. The SCSI interface for the SSM board supports the target 
adapter on the SSM board plus seven additional target adapters. 


The SCSI 1/2-inch tape is located on SSM SCSI bus ssm_scsi and its assigned 
configuration unit number is unit. The unit number, if not wild-carded, corre- 
sponds to the target adaptor number of the device and also is an index into the 
ssm_scsi_config table in the file /etc/conf/uts/io/ssm/ssm_space.c. The unit 
number must be unique with respect to other devices on this SSM SCSI bus. 
Both the ssm_scsi and unit may be specified with a "?," meaning they are wild- 
carded. If ssm_scsi is wild-carded, the system will assign the number of the 
SSM SCSI bus on which the tape is physically located. If unit is wild-carded, 
the system will assign the configuration unit number of the first unused 
matching entry in the ssm_scsi_config table. A tape matches if its target 
adapter number matches the target adapter number specified in the 
ssm_scsi_config table entry. The segsize field is the size of address space 
reserved for DMA transfers and must be 32768. The nsegs field indicates how 
many regions to reserve for DMA transfers for this device and must be 1. 


If a write is performed as the last operation before a tg device is closed, two 
tapemarks will be written to the tape immediately after the last written data. 
If the tape drive is not to be rewound after closing, the tape head will be posi- 
tioned between the tape marks. 


The standard device names begin with tg followed by a number representing 
the tape unit, that is, tg0 through tg7. The corresponding no-rewind device 
name has an n appended to the standard name, that is, tg0n through tg7n. 


BINARY CONFIGURATION 


The tg_bconf array in the device driver binary configuration file 
(/etc/conf/uts/io/tg/tg_space.c) must contain an entry for each drive that 
may be configured; the entries must be in the same order as the “device” 
entries in the kernel configuration file. As installed, tg_bconf has entries for 7 
drives. Unused entries are ignored. 


Tuning Parameters 
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The following tuning parameters are defined for each drive in the tg_bconf 
array of the binary configuration file: 


(1) Flags for configurable features. The flags available are: 


TMC_PRSENSE 
When this flag is set, all SCSI request sense buffers will be 
printed out, along with the command that caused the sense 
condition. Otherwise, only sense buffers that are in some way 
unusual will be printed out, such as media and hardware 
errors. 
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TMC_RSENSE 
When this flag is set, all SCSI request sense buffers associated 
with SCSI READ operations that caused a sense condition will 
be printed out. 
TMC_WSENSE 
When this flag is set all SCSI request sense buffers associated 
with SCSI write and write filemark operations that caused a 
sense condition will be printed out. 
TMC_SSENSE 
When this flag is set all SCSI request sense buffers associated 
with SCSI space operations which caused a sense condition 
will be printed out. 
FILES 
/etc/conf/utsio/tg/tg_space.c Raw magtape devices 
/dev/rmt/tg* Raw magtape devices 
/etc/conf/utsio/tg/tg_space.c Raw magtape devices 
/dev/mt/tg* Block magtape devices 
/etc/conf/utsio/tg/tg_space.c Binary configuration file 
SEE ALSO 


mt(1), mtio(7) 
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NAME 


timod — Transport Interface cooperating STREAMS module 


DESCRIPTION - 
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timod is a STREAMS module for use with the Transport Interface (TT) func- 
tions of the Network Services library. The timod module converts a set of 
ioct](2) calls into STREAMS messages that may be consumed by a transport 
protocol provider which supports the Transport Interface. This allows a user 
to initiate certain TI functions as atomic operations. 


The timod module must be pushed (see Streams Primer) onto only a stream 
terminated by a transport protocol provider which supports the TI. 


All STREAMS messages, with the exception of the message types generated 
from the ioctl commands described below, will be transparently passed to the 
neighboring STREAMS module or driver. The messages generated from the fol- 
lowing ioctl commands are recognized and processed by the timod module. 
The format of the ioctl call is: 


#include <sys/stropts.h> 


struct strioctl strioctl; 
strioctl.ic_cmd = cmd; 
strioctl.ic_timeout = INFTIM; 
strioctl.ic_ len = size; 
strioctl.ic dp = (char *)buf 
doctl(fildes, I_STR, &strioctl); 


Where, on issuance, size is the size of the appropriate TI message to be sent to 

the transport provider and on return size is the size of the appropriate TI mes- 
sage from the transport provider in response to the issued TI message. bufis a 
pointer to a buffer large enough to hold the contents of the appropriate TI mes- 
sages. The TI message types are defined in <sys/tihdr.h>. The possible values 
for the cmd field are: 


TI_BIND Bind an address to the underlying transport protocol pro- 
vider. The message issued to the TI_BIND ioctl is equivalent 
to the TI message type T.BIND_REQ and the message returned 
by the successful completion of the ioctl is equivalent to the 
TI message type T_BIND_ACK. 


TILUNBIND Unbind an address from the underlying transport protocol 
provider. The message issued to the TI_UNBIND ioctl is 
equivalent to the TI message type T.UNBIND_REQ and the 
message returned by the successful completion of the ioctl is 
equivalent to the TI message type T.OK_ACK. 


TI_GETINFO Get the TI protocol specific information from the transport 
protocol provider. The message issued to the TILGETINFO 
ioctl is equivalent to the TI message type T_INFO_REQ and 
the message returned by the successful completion of the 
ioctl is equivalent to the TI message type T_INFO_ACK. 
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TILOPTMGMT Get, set or negotiate protocol specific options with the trans- 
port protocol provider. The message issued to the 
TILOPTMGMT ioctl is equivalent to the TI message type 
T_OPIMGMT_REQ and the message returned by the successful 
completion of the ioctl is equivalent to the TI message type 
T_OPTMGMT_ACK. 
FILES 
<sys/timod.h> 
<sys/tiuser.h> 
<sys/tihdr.h> 
<sys/errno.h> 
SEE ALSO 
tirdwr(7) 
DIAGNOSTICS 
If the ioctl system call returns with a value greater than 0, the lower 8 bits of 
the return value will be one of the TI error codes as defined in <sys/tiuser.h>. 
If the TI error is of type TSYSERR, then the next 8 bits of the return value will 
contain an error as defined in <sys /errno.h> (see intro(2)). 
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NAME 


tirdwr — Transport Interface read/write interface STREAMS module 


© DESCRIPTION 
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tirdwr is a STREAMS module that provides an alternate interface to a trans- 
port provider which supports the Transport Interface (TI) functions of the Net- 
work Services library (see Section 3N). This alternate interface allows a user 
to communicate with the transport protocol provider using the read(2) and 
write(2) system calls. The putmsg(2) and getmsg(2) system calls may also 
be used. However, putmsg and getmsg can only transfer data messages 
between user and stream. 


The tirdwr module must only be pushed [see J_LPUSH in streamio(7)] onto a 
stream terminated by a transport protocol provider which supports the TI. 
After the tirdwr module has been pushed onto a stream, none of the Trans- 
port Interface functions can be used. Subsequent calls to TI functions will 
cause an error on the stream. Once the error is detected, subsequent system 
calls on the stream will return an error with errno set to EPROTO. 


The following are the actions taken by the tirdwr module when pushed on the 
stream, popped [see I_POP in streamio(7)] off the stream, or when data passes 
through it. 


push— _ When the module is pushed onto a stream, it will check any exist- 
ing data destined for the user to ensure that only regular data mes- 
sages are present. It will ignore any messages on the stream that 
relate to process management, such as messages that generate sig- 
nals to the user processes associated with the stream. If any other 
messages are present, the I_PUSH will return an error with errno 
set to EPROTO. 

write— The module will take the following actions on data that originated 
from a write system call: 

— All messages with the exception of messages that contain con- 
trol portions (see the putmsg and getmsg system calls) will be 
transparently passed onto the module’s downstream neighbor. 

— Any zero length data messages will be freed by the module and 
they will not be passed onto the module’s downstream neighbor. 

~ Any messages with control portions will generate an error, and 
any further system calls associated with the stream will fail 
with errno set to EPROTO. 

read — The module will take the following actions on data that originated 
from the transport protocol provider: 

— All messages with the exception of those that contain control 
portions (see the putmsg and getmsg system calls) will be 
transparently passed onto the module’s upstream neighbor. 

— The action taken on messages with control portions will be as 
follows: 

+ Messages that represent expedited data will generate an 
error. All further system calls associated with the stream 
will fail with errno set to EPROTO. 
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+ Any data messages with control portions will have the con- 
trol portions removed from the message prior to passing 
the message on to the upstream neighbor. 


+ Messages that represent an orderly release indication 
from the transport provider will generate a zero length 
data message, indicating the end of file, which will be sent 
to the reader of the stream. The orderly release message 
itself will be freed by the module. 


+ Messages that represent an abortive disconnect indication 
from the transport provider will cause all further write 
and putmeg system calls to fail with errno set to ENXIO. 
All further read and getmsg system calls will return zero 
length data (indicating end of file) once all previous data 
has been read. 


+ With the exception of the above rules, all other messages 
with control portions will generate an error and all further 
system calls associated with the stream will fail with errno 
set to EPROTO. 


— Any zero length data messages will be freed by the module and 
they will not be passed onto the module’s upstream neighbor. 
pop — When the module is popped off the stream or the stream is closed, 
the module will take the following action: 


— Ifan orderly release indication has been previously received, 
then an orderly release request will be sent to the remote side of 
the transport connection. 


SEE ALSO 
streamio(7), timod(7), intro(2), getmsg(2), putmsg(2), read(2), write(2), intro(3) 
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NAME 


tm — SCSI tape controller 


CONFIGURATION ENTRY 


tm on ssm_scsi ssm_scsi unit unit segsize 131072nsegs 2 


DESCRIPTION 


This device driver supports SCSI target adapters for streaming tape drives. It 
supports up to eight tape drive units spread across the SSM boards in the sys- 
tem. The SCSI interface for the SSM board supports the target adapter on the 
SSM board plus seven additional target adapters. 


The SCSI tape is located on SSM SCSI bus ssm_scsi and is configuration unit 
number unit. The unit number, if not wild-carded, corresponds to the target 
adaptor number of the device and also is an index into the ssm_scsi_config 
table in the file /etc/conf/uts/io/ssm/ssm_space.c. The unit number must be 
unique with respect to other devices on this SSM SCSI bus. Both the ssm_scsi 
and unit may be specified with a "?," meaning they are wild-carded. If 
8sm_scsi is wild-carded, the system will assign the number of the SSM SCSI 
bus on which the tape is physically located. If unit is wild-carded, the system 
will assign the configuration unit number of the first unused matching entry 
in the ssm_scsi_config table. A tape matches if its target adapter number 
matches the target adapter number specified in the ssm_scsi_config table 
entry. The segsize field is the size of address space reserved for DMA transfers 
and must be 131072. The nsegs field indicates how many regions to reserve 
for DMA transfers for this device and must be 2. 


The standard device names begin with tm followed by a number representing 
the tape unit, that is, tm0 through tm7. The corresponding no-rewind device 
name has an n appended to the standard name, that is, tmOn through tm7n. 


Implications of Streaming 
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Because the tm driver supports streaming tapes, the interface to the tm 
driver is different from that of ‘standard’ tape drives, in the following ways: 


Block interface 
The block interface is not supported at all. Attempts to use it will 
return ENXIO. 


Raw interface 
To provide reasonable performance and drive life, transfers to and 
from the tape must be done in large chunks. The tm driver assures 
this by buffering data internally. One consequence of this is that 
errors on writes often cannot be reported until long after the user pas- 
sed the data to the driver. Write errors will be reported to the user 
program on the next write system call after the error occurred, or on 
the close system call following the error. 


The raw interface does not support block sizes like the standard tape 
does. The tm tape device has a 512-byte physical block size. User 
records are packed into these physical blocks on a write and unpacked 
from these blocks on a read. When reading, the user gets the number 
of bytes requested, until end-of-file is encountered. Ifless than a mul- 
tiple of 512 bytes was written, the file size will be rounded up to a mul- 
tiple of 512 bytes. The extra bytes contain zeros. 
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Reading part-way into a file on the no-rewind device, closing the 
device, and re-opening it will not work as expected. The tape will 
always space forward to the beginning of the next file on a close. 


Operational Information 
Normally, a tape is retensioned when it is first opened for a read or ioctl call. 
Likewise, it is erased when it is first opened for a write call. This behavior is 
binary configurable (see Tuning Parameters). Note that if the first operation 
performed on the tape after insertion (or booting) is ‘mt retension’, the tape 
will be retensioned twice. This automatic retensioning of the tape helps 
ensure good data transfer, especially on writes to the tape. 


The data capacity of a tape will decrease with the number of soft errors on the 
tape and the number of times the drive must reposition between writes to the 
tape. These consume tape space. A reasonable expectation for a 600-foot tape 
is about 60 Mbytes. 


The mean time between failure of the tape drive is also affected by the number 
of repositions while reading or writing the tape. The tape drive will “stream” 
better when it is accessed under a light system load. 


The tape is rewound when a standard device (tm0 through tm7) is closed. 
This implicit rewind operation is performed asynchronously, that is, the 
close(2) system call may return although the tape is still rewinding. Subse- 
quent attempts to access the drive will wait for the asynchronous operation to 
complete, but other processing will not be delayed. 


IOCTLS 
A subset of the ioctl functions are supported at this time. Here is a list of sup- 
ported and non-supported functions: 


MTFSF Supported. (mt fef nn) 
MTWEOF Supported. (mt weof nn) 
MTFSR Not supported. 

MTBSR Not supported. 


MTSEOD Supported. (mt eod) 
MTREW — Supported. (mt rewind) 
MTERASE Supported. (mt erase) 


MTOFFL Not supported. 
MTBSF Not supported. 
MTRET Supported. (mt retension) 


The MTERASE ioctl erases the entire tape and then rewinds it. Reading sta- 
tus (mt status) is not supported. 


ioctls will not always behave as expected if they are intermixed with reads and 
writes in a program. 

BINARY CONFIGURATION 
The tm_bconf array in the device driver binary configuration file 
(/etc/conf/uts /io/tm /tm_space.c) must contain an entry for each drive that 
may be configured; the entries must be in the same order as the “device” 


entries in the kernel configuration file. As installed, tm_bconf has entries for 
4 drives. Superfluous entries are ignored. 
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Tuning Parameters 

The following tuning parameters are defined for each drive in the tm_bconf 

array of the binary configuration file: 

(1) The buffer size (in K bytes) used to buffer data for I/O transfers. Two 
buffers, each of this size, are allocated from the kernel’s free page pool 
when the device is opened. These buffers are used to improve tape 
streaming performance. The buffer space is released when the device 
is closed. 


(2) Flags for configurable features. The flags available are: 


TMC_OPENFAIL 
When this flag is set, open calls to this device can fail for lack 
of physical memory for the buffers. When this flag is clear, 
the buffer memory will always be allocated, but the process 
may block during this allocation process while other processes 
are swapped out to free up memory. 


TMC_AUTORET 
When this flag is set, the device will retension automatically 
on the first access after the tape has been changed. When 
clear, it will not retension automatically. 


TMC_PRSENSE 
When this flag is set, all SCSI request sense buffers will be 
printed out, along with the command that caused the sense 
condition. Otherwise, only sense buffers that are in some way 

ie unusual will be printed out, such as media and hardware 

errors. 

TMC_RSENSE 
When this flag is set, all SCSI request sense buffers associated 
with SCSI READ operations that caused a sense condition will 
be printed out. 


TMC_WSENSE 
When this flag is set, all SCSI request sense buffers associated 
with SCSI write and write filemark operations that caused a 
sense condition will be printed out. 
TMC_SSENSE 
When this flag is set, all SCSI request sense buffers associated 
with SCSI space operations which caused a sense condition 
will be printed out. 
(3) bits: This should always be a 1 for proper operation of fixed block 
devices. 
FILES 
/Jetc/conf/utsfio/tm/tm_space.c Raw files 
/dev/rmt/tm* Raw files 
/etc/conf/uts/io/tm/tm_space.c Binary configuration file 


SEE ALSO 


i) mt(1), mtio(7), t9(7) 
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WARNINGS 
Determining when the tape can safely be removed from the drive is difficult 
after closing a standard device (tm0 through tm7). The implicit tape rewind 
must complete prior to media removal. After closing, subsequent attempts to 
access the drive, such as with an mt noret command, will not complete until 
the rewind has finished. 


BUGS 
The double file mark at the end of the tape cannot be supported. 
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NAME 


ts — SCSI tape controller 


CONFIGURATION ENTRY 


ts on sec_scsi sec_scsi unit unit 


‘DESCRIPTION 


This device driver supports SCSI target adapters for streaming tape drives. It 
supports up to four tapes per target adapter and a maximum of seven target 
adapters per SCED board, not to exceed eight tapes in the entire system. 


The SCSI tape is located on SCED SCSI bus sec_scsi and is configuration unit 
number unit. The configuration unit number is an index into the sec_scsi_con- 
fig table in the file /etc/conf/uts/io/sec/sec_space.c , which specifies the tar- 
get adapter number. The unit number must be unique with respect to other 
devices on this SCED SCSI bus. Both the sec_scsi and unit may be specified 
with a "?," meaning they are wild-carded. If sec_scsi is wild-carded, the system 
will assign the number of the SCED SCSI bus on which the tape is physically 
located. If unit is wild-carded, the system will assign the configuration unit 
number of the first unused matching entry in the sec_scsi_config table. A tape 
matches if its target adapter number matches the target adapter number 
specified in the sec_scsi_config table entry. 


The standard device names begin with ts followed by a number representing 
the tape unit, that is, ts0 through ts7. The corresponding no-rewind device 
name has an n appended to the standard name, that is, ts0n through ts7n. 


Because the ts driver supports streaming tapes, the interface to the ts driver 


@ Implications of Streaming 
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is different from that of ‘standard’ tape drives, in these ways: 


Block interface 
The block interface is not supported at all. Attempts to use it will 
return ENXIO. 


Raw interface 
To provide reasonable performance and drive life, transfers to and 
from the tape must be done in large chunks. The ts driver assures 
this by buffering data internally. One consequence of this is that 
errors on writes often cannot be reported until sometime long after the 
user passed that data to the driver. Write errors will be reported to 
the user program on the next write system call after the error 
occurred, or on the close system call following the error. 


The raw interface does not support block sizes in the same fashion 
that standard tape does. The ts tape device has a 512-byte physical 
block size. User records are packed into these physical blocks on write 
and unpacked from these blocks on read. So, when reading, the user 
gets as many bytes as he asks for, until end-of-file is encountered. If 
less than a multiple of 512 bytes was written, the file size will be 
rounded up to a multiple of 512 bytes. The extra bytes contain zeros. 


Reading part-way into a file on the no-rewind device, closing the 
device, and re-opening it will not work as expected. The tape will 
always space forward to the beginning of the next file on close. 
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Operational Information 
A tape is always retensioned when it is first opened for read or ioctl. It is 
erased when it is first opened for write. Note that if the first operation per- 
formed on the tape after insertion (or booting) is mt retension, the tape will 
be retensioned twice. This automatic retensioning of the tape is to help 
ensure good data transfer, especially on writes to the tape. 


The data capacity of a tape will decrease with the number of soft errors on the 
tape and the number of times the drive must reposition between writes to the 
tape. These consume tape space. A reasonable expectation for a 450-foot tape 
is about 44 Mbytes. 
The mean time between failure of the tape drive is also affected by the number 
of repositions while reading or writing the tape. The tape drive will ‘stream’ 
better when it is accessed under light system load. 

IOCTLS 
A subset of the ioct] functions are supported at this time. Here is a list of sup- 
ported and non-supported functions: 


MTFSF Supported (mt fef nn) 
MTWEOF Supported (mt weof nn) 
MTFSR Not supported 

MTBSR_ Not supported 


MTSEOD Supported (mt eod) 
MTREW _ Supported (mt rewind) 
MTERASE Supported (mt erase) 


MTOFFL Not supported 

MTBSF Not supported 

MTRET Supported (mt retension) 
The MTERASE ioctl erases the entire tape and then rewinds it. Reading sta- 
tus (mt status) is not supported. 


loctls will not always behave as expected if they are intermixed with reads 
and writes in a program. 

BINARY CONFIGURATION 
The tsbconf array in the device driver binary configuration file 
(/etc/conf/uts /io/ts /ts_space.c) must contain an entry for each drive that 
may be configured; the entries must be in the same order as the ‘device’ 
entries in the kernel configuration file. As installed, tsbconf has entries for 4 
drives. Superfluous entries are ignored. 


Tuning Parameters 
The following tuning parameters are defined for each drive in the tsbconf 


array of the binary configuration file: 

(1) The buffer size (in K bytes) used to buffer data for I/O transfers. Two 
buffers, each of this size, are allocated from the kernel’s free page pool- 
when the device is opened. These buffers are used to improve tape 
streaming performance. The buffer space is released when the device 
is closed. 


(2) Flags for configurable features. Flags available are: 
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FILES 


SEE ALSO 


) BUGS 
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TSC_OPENFAIL 
When this flag is set, open calls to this device can fail for lack 
of physical memory for the buffers. When this flag is clear, 
the buffer memory will always be allocated, but the process 
may block during this allocation process while other processes 
are swapped out to free up memory. 

TSC_AUTORET 
When this flag is set, the device will retension automatically 
on the first access after the tape has been changed. When 
clear, it will not retension automatically. 


TSC_PRSENSE 
When this flag is set, all SCSI request sense buffers will be 
printed out, along with the command which caused the sense 
condition. Otherwise, only sense buffers which are in some 
way unusual will be printed out. 


bits: For the ADSI and Emulex target adapters, this should always be 
a 1 for proper operation of the device. 


/etc/conf/utsio/ts/ts_space.c Raw file 
/dev/rmt/ts* Raw file 
/etc/conf/utsAo/ts/ts_space.c Binary configuration file 


mt(1), mtio(7), sd(7) 


The double file mark at the end of the tape cannot be supported. 
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NAME 


tty — controlling terminal (gentty) interface 


2 CONFIGURATION ENTRY 


pseudodevice gentty 


DESCRIPTION 


FILES 


The file /dev/tty is, in each process, a synonym for the control terminal associ- 
ated with the process group of that process, if any. It is useful for programs or 
shell sequences that wish to be sure of writing messages on the terminal no 
matter how output has been redirected. It can also be used for programs that 
demand the name of a file for output, when typed output is desired and it is 
tiresome to find out what terminal is currently in use. 


The controlling terminal is established only by a controlling process. Such a 
process must be a session leader and must not already have established a con- 
trolling terminal. The terminal must not already be someone else controlling 
terminal, in which case an open without O_NOCTTY set will establish it. 


When the controlling terminal is relinquished, subsequent reads and writes 
will return ENXIO and subsequent opens will return EIO. 


/devitty 
/devitty* 


SEE ALSO 
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console(7), dev_to_ttyname(3C) 
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NAME 


usclk - 32-bit microsecond counter 


CONFIGURATION ENTRY 


pseudodevice usclk 


DESCRIPTION 


This device provides access to a 32-bit counter which increments every 
microsecond. This counter can be used to do fine-grain timing studies on pro- 
gram execution. This device does not support read(Q) and write() system call 
access. To access the counter, this device must be mapped into a process's 
memory (see mmap(2seq)). Only one page of usclk memory can be mapped 
into a process (see getpagesize(2seq)). Requests to mmap more will fail. 
The device can only be mmaped READ ONLY. Generally, this device should 
be accessed only through the usclk_init(3seq) and getusclk(3seq) library 
functions or the GETUSCLK macro defined in /usr/include/usclke.h. 


Symmetry systems implement this counter as a set of 32-bit registers on the 
processor boards. Each processor has its own counter register. But, the ini- 
tialization and incrementing of these counter registers is synchronized across 
all processor boards. The resulting effect is as though there were only one 
counter register. However, accessing this counter involves no accesses off the 
processor board. So, by mapping the device into the process's address space, 
the overhead of accessing the counter is essentially zero. 


DIAGNOSTICS 
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EINVAL An attempt was made to map with write access. 


ENOSPC An mmap request tried to map more than one page of the usclk 
device. Refer to getpagesize(2seq). 

ENXIO An open request is denied because /dev/usclk has a minor device 
number greater than one. 
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NAME 
+) vtoc — VTOC partitioning driver 
CONFIGURATION ENTRY 
pseudodevice vtoc 


DESCRIPTION 
This device driver provides the VTOC style of disk partitioning, which means 
that access is provided to the underlying disk space via partitions which are 
described by the disk itself. This is a "virtual" device driver, in that it requires 
an actual disk device (such as a zd, sd, or wd device) which contains a valid 
VTOC in the correct location to build upon. 


Disk device drivers do not provide any partitions, but present the entire disk 
surface for use. To make this so-called "unpartitioned” disk more useful, the 
disk surface may be partitioned into up to 255 non-overlapping sections. Each 
of these disk sections are accessed via a separate minor number. 


Special files with minor device numbers 0 through 254 refer to various por- 
tions of drive 0; minor devices 256 through 510 refer to drive 1, etc. The spe- 
cial files with minor number 255 refers to drive 0 in the unpartitioned state, 
and is not accessible if a partitioning driver is in place on this disk. The stan- 
dard device names begin with the disk controller name (e.g., zd or wd), fol- 
lowed by the drive number, followed by the letter s, and then a number from 
0-254 —e.g., zd0s0. By convention, these special files are found in the direc- 
tory /dev/dsk. - 


The block devices access the disk via the system’s normal buffering mecha- 
i.) nism and may be read and written without regard to physical disk records. 
There is also a raw interface that provides for direct transmission between the 
disk and the user’s read or write buffer. Raw transfers are limited to a maxi- 
mum raw transfer size. The maximum raw transfer size is specific to each 
driver, but is usually 256 512-byte sectors. In raw I/O, counts must be a mul- 
tiple of 512 bytes, and must begin on 16-byte aligned memory addresses. Like- 
wise, lseek calls should specify a multiple of 512 bytes. A single read or write 
call usually results in exactly one I/O operation, which transfers data directly 
to the users address space. Therefore raw I/O is considerably more efficient 
when many words are transmitted. The names of the raw special files are con- 
ventionally the same as the block special files, and are found in the directory 
/dev/rdsk — e.g., /dev/rdsk/wd0s0. In addition to these regular device inter- 
faces, there is a "diagnostic" interface to the disk once the VTOC driver is 
present. This interface will allow VTOC ioctls to be issued and also provides a 
read-only interface to the entire unpartitioned disk address space. The special 
file for the diagnostic interface has a major and minor device number equal to 
the unpartitioned device with 32768 added to the major number. By conven- 
tion, this special file is in the directory /dev/diag/rdsk —e.g., 
/dev|/diag /rdsk/sd0. 
Note that when the vtoc driver is in place on a disk, the unpartitioned inter- 
face to the disk becomes "unavailable," which means that all attempts to open 
the unpartitioned disk will fail with ENXIO. 


Partition Data . 
@ The partition data resides in an area of the disk called the "Volume Table of 
Contents” ( VTOC ) which is at most V_SIZE sectors long, and resides at sector 
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V_VTOCSEC, offset by any reserved cylinders a disk may have. 


The structure of the VTOC is described in /usr/include/sys/vtoc.h . Some of @ 
the fields include: 
v_sanity 

This is a magic cookie which identifies this section of the disk as a 

valid VTOC. It is normally set to VTOC_SANE. 


v_version 


The version of this particular VTOC. 


v_cksum 
Achecksum, which allows the contents of the VITOC to be verified. 


The number of valid partitions in this VTOC. 
v_secsize 

The size in bytes of sectors on this disk. 
u_ntracks 

The number of tracks per cylinder. 
v_nsectors 

The number of sectors per track. 


u_ncylinders 
The number of cylinders on this disk. The parameters v_ntracks, 
v_nsectors , and u_ncylinders are used to make filesystems. Since it is 
not always possible to know the exact geometry of a disk or a disk may 
not have a fixed geometry, these values should be chosen to reflect the 
total size of the disk when multiplied together. 


v_rpm The number of disk revolutions-per-minute. 


u_disktype 
This is a character array which gives the name of the disk type. It is 
at most VTYPCHR characters long. 


v_part Per-partition data. 

Each partition has data associated with it. That information includes: 
p_start The sector number where this partition starts. 

p_size The size of this partition in sectors. 

p_type The type of this partition. 


p_bsize 
The size in bytes of filesystem blocks to be made for this partition. 


p_fsize The filesystem fragment size in bytes for this partition. 
The parameters p_bsize and p_fsize will only be needed if a filesystem is to be 
made on this partition. If no filesystem will be made on this partition, then 
these values are not significant. 

Partition Types 
Each partition can have associated with it a partition type, which is recorded 
in the per-partition section of the VTOC. The partition types are: 
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V_NOPART 
This type indicates that this slot in the partition table is empty. No 
device will be made available which corresponds to this minor device 
number. 


V_RAW This is a regular partition. Partitions of this type may have filesys- 
tems constructed on them, or may be used as raw disk partitions. 


V_BOOT 
System bootstrap area. These partitions are like partitions of type 
V_RAW, but they have added meaning in that commands which write 
system bootstraps to disk will by default look for the first partition of 
type V_BOOT to write the bootstrap to. 


V_RESERVED 
This designates an area of the disk that may not be accessed under 
normal circumstances, since it maps an area of the disk reserved for 
some specific purpose. For example, some disk controllers require that 
areas of the disk be reserved for bad block lists or configuration infor- 
mation. Most disk types also reserve space for diagnostic routines to 
read and write the disk without destroying data. The VTOC itself is 
mapped as reserved space. Programs that write VTOCs directly 
should disallow any attempt to change the definition of partitions of 
this type, or serious problems may result. 


V_FW System controller firmware area. These partitions are like partitions 
of type V_RAW but they have added meaning in that commands which 
write system bootstraps to disk will by default look for the first parti- 
tion of type V_FW to write the firmware to. The firmware is only writ- 
ten if the system has a system controller board with loadable firm- 
ware. 


IOCTLS 
This driver supports the following commands to ioctl0: 


V_BUILD 
This ioctl is used to build a VTOC device from an unpartitioned device. 
It should be passed to the device which is normally called /dev/vtoc 
and have, as the third argument to the system call, an open file 
descriptor for a disk which does not have a partitioning driver in place. 
A possible coding example using this ioctl would be: 


fd = open("/dev/vtoc", O_RDWR); 
fdl = open("/dev/rdsk/zd1", O_RDWR); 
doctl(fd, V_BUILD, fdl); 


If the ioct] is successful, the file descriptor passed as the third argu- 
ment should be treated as if it has already been closed and a subse- 
quent cloge() operation is not needed on this descriptor. This is nec- 
essary, since a successful V_BUILD operation will make the unparti- 
tioned device inaccessible. (i.e., /dev/rdsk/zd1 can no longer be 
opened if the V_BUILD operation above is successful). 


V_DESTROY 
@ a The VTOC device in place on a disk is instructed to destroy all of the 
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devices associated with partitions on this disk. The unpartitioned 
device is made available for use again. This ioct] will fail with EBUSY 
if any of the partitions which make up this disk are open, being used 
as a swap device, or has a mounted filesystem. The semantics of this 
ioctl are identical to the V_BUILD ioctl, with the exception that the 
third argument to the ioct] call is the file descriptor from opening any 
valid partition on this disk or from opening the diagnostic device for 
this disk. 

V_READ 
This ioctl will cause the VTOC to be read from disk and returned to 
the caller. This is the only way to read the VTOC, since read/write 
access to the VTOC area is disallowed when a VTOC driver is present. 
The third argument to the ioctl call should be a pointer to an area of 
memory large enough to store the entire struct vtoc. For portability to 
future versions of the kernel, a block of size V_SIZE should be allo- 
cated for struct vtoc. 

V_WRITE 
This ioct] will cause the VTOC to be written to disk. This is the only 
way to write the VTOC, since read/write access to the VTOC area is 
disallowed when a VTOC driver is present. The third argument to the 
ioctl call should be a pointer to a filled-out struct vtoc which will be 
sanity-checked before being written to disk. If the VTOC fails a san- 
ity-check, then EINVAL is returned. This may include overlapping par- 
titions, or an attempt to put a partition over the VTOC area of the 
disk which is not of type V-RESERVED. Ifa partition is changed in the 
new VTOC relative to the old VTOC (i.e., any of the per-partition data 
is changed), that partition must not be mounted or being used as a 
swap device, and the raw device must not be open by any process. 


V_WRITEPROTECT 
This ioctl] acts as a software write-protect switch. The first argument 
to the ioctl call should be an open file-descriptor to a raw partition. 
When V_WRITEPROTECT is run, all subsequent attempts to open for 
writing the character-special or block-special device for this partition 
will result in EBUSY being returned in errno. Note that the mount(2) 
system call performs the equivalent of a V_WRITEPROTECT ioct] to the 
mounted device. 


V_WRITEENABLE 
This ioct] reverses the effect of the V_.WRITEPROTECT ioctl, allowing 
the partition’s character and block-special devices to be opened for 
writing. 
DEVTAB ENTRY 
In order for the vtoc driver to get established on disks automatically at sys- 
tem boot time, the file /dev/devtab must have lines added which direct the 
binding of the vtoc driver to the disk. Lines for vtoc in /etc/devtab have the 
following form: 


vtoc _ special 
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FILES 


where special is a character special file for an unpartitioned physical disk 
device. If the vtoc driver becomes successfully established on the disk, special 
will become unavailable for use and the partitioned devices themselves 
become usable. 


For example, consider the following lines from /etc/devtab: 


vtoc /dev/rdsk/zdl 
vtoc /dev/rdsk/sd0 
vtoc /dev/rdsk/sdl 


These lines will automatically build a vtoc driver on zd1, sd0, and sd1. Note 
that the root disk should not be listed, since a vtoc driver is established on 
the root disk automatically. In addition, if the primary swap device is on a dif- 
ferent disk than the root, then a vtoc driver gets established on this disk 
automatically as well. 


/dev/vtoc 
/dev/dsk/* 
/dev/rdsk/* 
/dev/diag/rdsk/* 
/etc/devtab 


SEE ALSO 
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cempt(7), devbuild(1M), devtab(4) 
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NAME 


wd —SSM SCSI disk controller 


CONFIGURATION ENTRY 


wd on ssm_scsi ssm_scsi unit unit segsize 131072nsegs 2 


DESCRIPTION 


This device driver controls SCSI disk with embedded targets ("embedded 
SCSI" disks). It supports up to seven embedded SCSI disks per SSM board. 
The SCSI disk is located on SSM SCSI bus ssm_scsi and is configuration unit 
number unit. The unit number, if not wild-carded, corresponds to the target 
adapter number of the device and also is an index into the ssm_scsi_config 
table in the file /etc/conf/uts/io/ssm/ssm_space.c. The unit number must be 
unique with respect to other devices on this SSM SCSI bus. Both the ssm_scsi 
and unit may be specified with a "?," meaning they are wild-carded. If 
ssm_scsi is wild-carded, the system will assign the number of the SSM SCSI 
bus on which the disk is physically located. If unit is wild-carded, the system 
will assign the configuration unit number of the first unused matching entry 
in the ssm_scsi_config table. A disk matches if its target adapter number 
matches the target adapter number specified in the ssm_scsi_config table 
entry. The segsize field is the size of address space reserved for DMA transfers 
and must be 131072. The nsegs field indicates how many regions to reserve 
for DMA transfers for this device and must be 2. 


The special file with minor device number 255 refers to drive wd0 (the first 
drive listed in the kernel configuration file), minor device number 511 refers to 
wd1l, and so on. Standard device names are of the form wdn, where n is the 
drive number. 


Block devices access the disk via the system’s normal buffering mechanism, 
and may be read and written without regard to physical disk records. These 
special files are usually found in /dev/dsk — e.g., /dev/dsk/wd0. There is also 
araw interface that provides for direct transmission between the disk and the 
user’s read or write buffer. Raw transfers are limited to a maximum of 256 
512-byte sectors. In raw I/O, counts must be a multiple of 512 bytes, and must 
begin on 16-byte aligned memory addresses. Likewise, lseek calls should 
specify a multiple of 512 bytes. A single read or write call usually results in 
exactly one I/O operation, which transfers data directly to the users address 
space. Therefore raw I/O is considerably more efficient when many words are 
transmitted. The names of the raw special files are conventionally the same 
as the block special files, and are found in the directory /dev/rdsk — e.g., 
/dev/rdsk/wd0. 


NOTE: The wd driver provides access to the entire disk, including reserved 
sectors. To make the device usable, a partitioning driver (like vtoc(7) or 
empt(7)) must be built on the unpartitioned disk. 


BINARY CONFIGURATION 
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Before attempting to add a new disk or target adapter, read the disk and tar- 
get adapter manuals thoroughly. The main information needed is how to set 
the target adapter number and drive-select cabling. 


Table of disk units. 
The wd_bconf array in the device driver binary configuration file 
(/ete/conf/wd_space.c) must contain an entry for each drive that may be 
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configured; the entries must be in the same order as the device entries in the 
kernel configuration file. 


Tuning Parameters 
Tuning parameters are defined for each drive in the wd_bconf array of the 
binary configuration file. Each element specifies the maximum number IATs 
(indirect access table entries used for scatter/gather I/O) for the corresponding 
drive unit. 
An indirect access table is used to map a contiguous J/O buffer in virtual mem- 
ory to the corresponding pages scattered throughout physical memory. Each 
table entry (IAT) can map up to 4096 bytes. The number of IATs determines 
the maximum transfer size for each read/write request. 


Since each drive may simultaneously map a maximum of two 128-Kbyte 
transfers, the maximum number of IATs every used is 64. 


FILES 
/dev/dsk/wd?s? Block files 
/dev/rdsk/wd?s? Raw files 
/usr/conf.new/uts/io/wd/wd_space.c Binary configuration file 

SEE ALSO 
devbuild(1M), mkvtoc(1M), newfs(1M), prtvtoc(1M), vtoc(7), empt(7), 
CCSformat(8) 

DIAGNOSTICS 


Embedded controller internal recovery and error reporting 
See the ANSI X3T9.2 (SCSI) specification. 
Firmware and SCSI bus level errors (reported as HARD errors) 


Command Block Busy 
Bad Command Block 
No Target 

SCSI Bus Error 


SCSI target adapter errors and actions taken 


Recovered Error 
SOFT error message, for information only 
Unit Attention 
Totally ignored 
Medium Error 
Hardware Error 
Illegal Request 
Data Protect 
Blank Check 
Vendor Unique 
Copy Aborted 
Aborted Command 
Equal 
Volume Overflow 
Miscompare 
Unrecognized Completion Code 
Retried four times with soft error messages; fifth error 
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produces Hard Error message 


In raw I/O, read(2),write(2), and lseek(2) should always deal in 512-byte mul- 
tiples. 

A program to analyze the logged error information (even in its present 
reduced form) is needed. 

The kernel ‘milliseconds per seek’ statistic is not kept for this device; thus, 
iostat(1) always reports zero for this statistic. 

When a request to the disk accesses past the end of media (for example, a non- 
existent block number), the device driver will report soft errors followed by a 
hard error in the same way that a bad block is treated. There is no special 
handling of the volume overflow sense error code for disks. 
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NAME 
& wp —SSM parallel line printer interface 


DESCRIPTION - 
The wp device driver supports the SSM controller for line printers using the 
Centronics or Dataproducts parallel interfaces. It supports one line printer 
per controller. 


The unit number of the printer is specified by the minor device number. The 
standard device names consist of “wp” followed by the line printer unit num- 
ber (e.g., wp0, wp1). wp devices are exclusive-access devices; that is, only one 
process may open a device at a time. 


BINARY CONFIGURATION 
The printer can be configured for one of three different modes which are 
described in lpmod(7). The different modes are implemented by Ipmod, a 
STREAMS module pushed onto the driver automatically when the device is 
opened. If the system is configured to not have this module pushed, the 
printer will always be in raw mode regardless of what is in the lp_config table. 
The table which causes this module to be pushed is in /etc/conf/uts/ker- 
nel /i386_space /autop_space.c. 
Raw mode provides an eight-bit data path to the printer. Tabs, formfeeds, 


newlines and other special characters are not expanded, and no line or page 
adjustments are made. 


To see a description of the other modes, refer to the man page for Ipmod. 
The interface type is defined as follows: 
Value Definition 


0 Centronics interface 
1 Data Products interface 


The configuration options are specified in a table in the binary configuration 
file, /ete/conf/uts/io/wp/wp_space.c. The first column specifies the line 
length. The second column specifies the mode. The third column specifies the 
printer interface type. Note that both the mode and the line length field are 
ignored by the driver and are only there for the benefit of modules which may 
be pushed onto the driver. The printer characteristics are indexed by the 
minor number of the device. If the minor number is greater than the number 
of entries in the array, the configuration options for the last entry in the table 
are used. 


For example, if you had the following hardware configuration: 
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printer 0 80 columns uppercase Centronics 
printer 1 132 columns raw Data Products 
printer 2 132 columns normal Data Products 
printer 3 80 columns normal Centronics 
printer 4 132 columns normal Centronics 
printer 5 132 columns normal Centronics 


you could use the following configuration table: 


struct wp_printer wpconfig[] = { 


/* cols, special _map, interface xf 

{ 80, PRCAPS, (e) be f* 0 AT 
{ 132, PRRAW, iz. by fe Lay 
{ 132, PRSPECIAL, 1 }, (* 2 4*f 
{ 80, PRSPECIAL, 0 yy SYS *7 
{ 132, PRSPECIAL, 0 de /* 4 */ 
} 


Note that the sixth printer (number 5) is not specified in the configuration but 
will have the same characteristics as printer number 4. 


The default configuration is as follows: 


struct wp_printer wpconfig[] = { 


f* cols, special map, interface */ 
{ 132, PRSPECIAL, 0 } » f* 0 */ 
ie 
FILES 
/dev/printer/wp* 
/etc/conf/utsio/wp/wp_space.c 
SEE ALSO 


1p(1), pr(1), lpadmin(1M), Ipstat(1), terminfo(4), |pmod(7) 
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NAME 


xs — Xylogics 781 terminal multiplexor driver 


CONFIGURATION ENTRY 


xs on vme ume unit unit segsize 1024nsegs 16 


DESCRIPTION 


The Xylogics 781 board provides 16 serial I/O lines. Each line is able to sup- 
port a modem or a terminal. The controller board is located on VME bus ume 
and is configuration unit number unit. The configuration unit number is an 
index into the xs_vme_config table in the file /etc/conf/uts/io/xs/xs_space.c. 
The unit number must be unique with respect to other xs devices on this VME 
bus. Both the ume and unit may be specified with a "?," meaning they are 
wild-carded. If ume is wild-carded, the system will assign the number of the 
VME bus in which the board is physically located. If unit is wild-carded, the 
system will assign the configuration unit number of the first unused matching 
entry in the xs_vme_config table. A board matches if it is at the address speci- 
fied in the xs_ume_config table entry. The segsize field is the size of address 
space reserved for DMA transfers and must be 1024. The nsegs field indicates 
how many regions to reserve for DMA transfers for this device and must be 16. 


Each line attached to the 781 terminal multiplexor behaves as described in 
streamtty(7). Input and output for each line may independently be set to run 
at any of the following speeds: B50, B75, B119 B150, B300, B600, B1200, 
B1800, B2400, B4800, B9600, and B19200 


RS232 output line DTR is enabled when the line is opened and disabled when 
the line is closed if the HUPCL flag is set. The RTS output line is used to con- 
trol the flow of data coming into the serial port. The CTS input line may be 
used to control the flow of data coming out of the serial port. The CTS input 
line floats to logic true on the 781 hardware. Break detection and generation 
are also supported. 


The initial baud rate and line state for all lines are defined by the xscflags 
variable in the binary configuration file, xs_space.c. These values are usually 
overridden (e.g., by getty(1a)) when a line is opened. 


Streams Driver Characteristics 
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The xs driver is a STREAMS-based tty driver as described in streamtty(7). 
Functionality which is unique to this driver is described below: 

When a set-parameters ioctl message is received with a baud rate of BO, this is 
considered to be a hangup message. DTR is dropped immediately. 

If a set-parameters ioct] message is received with an illegal baud rate, the 
message will be rejected and the line state will not be changed. 

The Xylogics 781 hardware is not allowed to perform any flow control. The 1d0 
module and the driver execute all flow control processing. If the driver 
receives an M_PCCTL message with a sub-type of MC_STOPI or MC_STARTI, 
only the first data byte in the message is sent to the peripheral device. 

A logic-high-to-logic-low transition on the DCD input is interpreted as a 
hangup signal. 

If the driver receives an M_IOCTL/M_PCIOCTL message with a sub-type of 
TCGETA/TCGETP and the message does not arrive with a pre-allocated data 
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buffer, the driver will allocate a streams buffer and attach it to the message. 


Refer to your hardware documentation for a description of standard wiring for 
Sequent terminals and modems. 


WARNINGS 
The SMC 78C808 Octart chip on the 781 hardware does not detect breaks in 
an industry-standard way. Therefore, the 781 firmware is required to do some 
special processing of break interrupts from the Octart in order to support rea- 
sonable break detect functionality. Because of this, any terminal connected to 
a 781 serial port must be set up to for a break duration of no more than 
250ms. Ifa longer break duration is sent to a 781 port, multiple break-detect 
messages will be sent from the driver to the user process, resulting in strange 
behavior. 


FILES 
/devi/tty<subdir>/<basename> 
/etc/conf/uts/io/xs/xs_space.c 
SEE ALSO 
tty(7), streamtty(7) 
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NAME 


xt — Xylogics 472 MULTIBUS magnetic tape interface 


CONFIGURATION ENTRY 


xt on multibus multibus unit unit segsize 1024nsegs 17 


DESCRIPTION 


The Xylogics 472 and an industry-standard Cipher formatted interface trans- 
port combine to provide a standard tape drive interface as described in 
mtio(7). The controller board is located on MULTIBUS multibus and is confi- 
guration unit number unit. The configuration unit number is an index into the 
xt_multibus_config table in the file /etc/conf/uts/io/xt/xt_space.c. The unit 
number must be unique with respect to other xt devices on this MULTIBUS. 
Both the multibus and unit may be specified with a "?," meaning they are wild- 
carded. If multibus is wild-carded, the system will assign the number of the 
MULTIBUS in which the board is physically located. If unit is wild-carded, 
the system will assign the configuration unit number of the first unused 
matching entry in the xt_multibus_config table. A board matches if it is at the 
address specified in the xt_multibus_config table entry. The interrupt vector 
cannot be checked, so care must be taken to ensure that the interrupt vector 
is jumpered to match the xt_multibus_config table entry. The segsize field is 
the size of address space reserved for DMA transfers and must be 1024. The 
nsegs field indicates how many regions to reserve for DMA transfers for this 
device and must be 17. 


The bits in the minor device number are as follows: The low-order two bits 
select the logical unit. As many as four transports on any combination of con- 
trollers and formatters are supported. The next bit, 004, specifies that the 
tape is not rewound when the associated special file is closed. 


The tape controller must be strapped up for 24-bit addressing. 


BINARY CONFIGURATION 
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When building a kernel with MULTIBUS magtape, be sure that the binary 
configuration information in /etc/conf/uts/io/xt/xt_space.c is up to date. 
The constants and variables defined in xt_space.c include: 


XTCTLR The maximum number of xt controllers supported by the 
driver. 
xtunits This array (indexed by logical unit from the minor device 


number) describes the controller and transport assignments 
that will be supported by the system. Wildcarding may be 
used to force the driver to probe each controller for the speci- 
fied tape drives. The example below describes two possible 
controllers, with two tape drives on each controller. 


structxt_unit xtunits[] = { 
/* ctlr drive */ 
{ ANY, ANY },/* xtO: any controller, any drive */ 
{ ANY, 1 },/* xtl: any controller, drive 1 */ 
{ ANY, 0 },/* xt2: any controller, drive 0 */ 
{ ANY, 1 },/* xt3: any controller, drive 1 */ 


ye 
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WARNINGS 
Standalone MULTIBUS magtape offers a subset of the facilities offered by 
UNIX MULTIBUS magtape. In particular, the standalone tape driver does 
not do density selection on open (the density must be set manually from the 
tape front panel), and does not do retries on I/O errors. 


FILES 
/dev/mt/xt* Block magtape devices 
/etc/conf/uts/io/xt/xt_space.c Block magtape devices 
/dev/rmt/xt* Raw magtape devices 
/etc/conf/uts/io/xt/xt_space.c Binary configuration file 
SEE ALSO 
mt(1), tar(1), mtio(7) 
DIAGNOSTICS 


xt%d: drive %d ctlr %d conflict. A drive was not wildcarded in the binary 
configuration, but the specified drive number was already in use (allocated to 
some previously probed tape device). 


xt%d: no write ring. An attempt was made to write on the tape drive when 
no write ring was present; this message is written on the terminal of the user 
who tried to access the tape. 


xt%d: not online. An attempt was made to access the tape while it was off- 
line; this message is written on the terminal of the user who tried to access 
the tape. 


xt%d: can’t switch density in mid-tape. An attempt was made to write on 
a tape at a different density than is already recorded on the tape. This mes- 
sage is written on the terminal of the user who tried to switch the density. 


xt%d: hard error bn%d er=0x%x. A tape error occurred at block bn. The 
error code is as described in the Xylogics manual. Any error is fatal on non- 
raw tape; when possible the driver or controller will have retried the opera- 
tion which failed several times before reporting the error. 


xt%d: recovered error bn%d. The controller was able to recover an error 
while reading or writing. 

BUGS 
If any non-data error is encountered on non-raw tape, it refuses to do anything 
more until closed. 


Due to a hardware limitation, the xt tape driver cannot tell the difference 
between a missing tape drive and a tape drive with no tape loaded. As a con- 
sequence, tape probing pretends it found all configured tape drives on any con- 
troller present in the system. Be careful with wildcarding in the binary confi- 
guration. 


Ifa drive supports more than one tape density, the user must manually select 
the desired tape density while loading the tape. 
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NAME 


zd — dual-channel disk controller 


© CONFIGURATION ENTRY 


zdc ctrl on sb8000 unit ? 
smde busno on zde ctrl unit ? 
zd on smde busno unit unit 


DESCRIPTION 
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This device driver controls SMD drives on the Sequent Dual-Channel Disk 
Controller (DCC). Each DCC can control up to eight SMD disk drives split 
across two DMA channels. All of the drives on the same channel must be iden- 
tical in type and format. 


The controller is specified by crt! . The controllers must be numbered sequen- 
tially starting at 0. The unit in the zdc configuration statement must be wild- 
carded. In the smde configuration statement the busno, SMD bus number, 
must be numbered sequentially starting at 0 and the unit must be wild- 
carded. The configuration unit number is an index into the zd_smde_config 
table in the file /etc/conf/uts/io/zd/zd_space.c. The unit number must be 
unique with respect to other zd devices on this SMD bus. The unit may be 
specified with a "?," meaning they are wild-carded. If unit is wild-carded, the 
system will assign the configuration unit number of the first unused matching 
entry in the zd_smde_config table. A drive matches if its drive number and 
drive type match the entry in the zd_smde_config table entry. In the 
zd_smde_config table either the drive number or the drive type will be be wild- 
carded, but not both. 


The special file with minor device number 255 refers to drive 0; minor device 
511 refers to drive 1, and so forth. The standard device names begin with zd 
followed by the drive number —e.g., zd0. By convention, these special files 
are found in the directory /dev/dsk. 


The block devices access the disk via the system’s normal buffering mecha- 
nism and may be read and written without regard to physical disk records. 
There is also a raw interface that provides for direct transmission between the 
disk and the user’s read or write buffer. Raw transfers are limited to a maxi- 
mum of 256 512-byte sectors. In raw I/O, counts must be a multiple of 512 
bytes, and must begin on 16-byte aligned memory addresses. Likewise, lseek 
calls should specify a multiple of 512 bytes. A single read or write call usually 
results in exactly one I/O operation, which transfers data directly to the users 
address space. Therefore raw I/O is considerably more efficient when many 
words are transmitted. The names of the raw special files are conventially the 
same as the block special files, and are found in the directory /dev/rdsk — 
e.g., /dev/rdsk/zd0. 


NOTE: The zd driver provides access to the entire disk, including bad block 
lists, configuration data, and diagnostic test tracks. To make the device 
usable, a partitioning driver (like vtoc(7) or empt(7)) must be built on the 
unpartitioned disk. Use of a zd device without a partitioning driver in place 
will result in system errors if the first sectors of the device are accessed. 


A drive may be spun up after the operating system is booted if the configura- 
tion for the drive is anchored (controller and drive numbers explicitly specified 
in the kernel configuration file) and there are no wildcarded drives configured 
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before the anchored drive. This is possible since the state of the disk drive and 
configuration is reassessed at each first open of the device. 


BINARY CONFIGURATION 


When building a kernel with DCC disks configured, be sure that the binary 

configuration information in /etc/conf/uts/io/zd/zd_space.c is up to date. 

The constants and variables defined in conf_zd.c include: 

zdc_iouperch 
This is the number of iovecs allocated per DCC command block. 
See /usr/include/sys/zdc.h. If the value is set to zero, the driver 
will allocate enough iovecs to handle the system’s notion of the 
maximum raw I/O transfer size (i.e., max_RAW_IO). Each iovec 
contains the physical address of a page in memory. The driver min- 
phys routine (zdminphys()) uses this variable to set the maximum 
raw I/O transfer size. 


zdretry The maximum number of times to retry errors. 


Disk Support 


FILES 


The driver supports the Fujitsu M2333K “Swallow,” the Fujitsu M2344K 
“Swallow 4,” the Fujitsu M2382K “Swallow 5,” and the Fujitsu M2351A 
“Eagle” disk drives. Other drives may be added to the configuration tables. 
The first cylinder (cylinder 0) is reserved to contain the bad block lists and 
disk description data. The last 2 cylinders are reserved for diagnostics. 


/dev/dsk/zd{0-31] Block files 
/dev/rdsk/zd[0-31] Raw files 
/ete/conf/uts/io/zd/zd_space.c Binary configuration file 


SEE ALSO 


devbuild(1M), mkvtoc(1M), newfs(1M), prtvtoc(1M), vtoc(7), empt(7), zdfor- 
mat(8) 


DIAGNOSTICS 


Errors during normal operation are signaled to the driver via completion 
codes in the command block or by controller error interrupts. In response to 
an error, the driver makes every reasonable attempt to complete the I/O 
request and to avoid panicking the system. Therefore, the driver will choose 
to shut down a DCC channel or entire DCC controller rather than panic the 
system. To shut down a DCC channel or controller means that all the drives 
on the DCC channel or controller are marked as bad and all the queued /O 
requests are failed. 
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NAME 
@& intro — introduction to system standalone utilities 


DESCRIPTION - 
This section outlines procedures for doing standalone system maintenance. 
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NAME 


@ SYNOPSIS 


boot — run a standalone program or bring up the operating system 


From the powerup monitor: 


on SCED-based systems: 
*b [ flag | [ program [ arg]... ] 


on SSM-based systems: 
--> bh [ [flag]program [ arg ] ...’] 


DESCRIPTION 
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boot brings up the operating system, or loads other standalone programs into 
memory. 


flag is the value of the configuration flag. Standalone programs (including 
boot and the operating system kernel) interpret various bits of the configura- 
tion flag. On SCED systems, if flag is not specified, a default value is taken 
from the most recent wf powerup monitor command. On SSM systems, if flag 
is not specified as part of the bootstring it defaults to zero. On SSM systems, 
there must not be any space characters between flag and program. Addi- 
tionally the single quotes are required only if the optional arg field is provided. 


If the lowest bit of the configuration flag is one (that is, if the configuration 
flag is odd), boot will ask for the name of the program to be loaded into mem- 
ory. Otherwise, the name is taken from the command line, or (if not present) 
the value specified the last time the bootstring was set from the powerup mon- 
itor. For SCED systems, the command for setting the bootstring is wn0=boot- 
string and for SSM systems, the command is bh os="bootstring’. 


The name of the program is given in standalone file notation. Standalone file 
notation is represented as: 


dv(un ,su)file 


where du is the name of the device driver, un and su are the unit and subunit 
parameters (interpreted by the device driver), and file is the name of the file to 
be run. Supported device drivers for SCED systems are sd, ts, xt and zd. 
Supported device drivers for SSM systems are wd and tm. In general, for disk 
drivers, wn selects among the various drives, su selects a particular disk parti- 
tion, and file is a file name relative to the top level directory of the file system 
located in the selected partition. For tape drivers, un selects among the vari- 
ous drives, sw selects a particular file on the tape (bounded by EOF tape 
marks), and file is unused. 


boot loads the program into memory, displays the allocation of text, data, 
and bss (uninitialized data), and then begins execution of the program. When 
the program exits, the powerup monitor resumes. 

Arguments for the program may follow the program name, as long as they are 
separated from the program name by at least one space. boot makes the 
entire (uninterpreted) command line available to the invoked program. The 
invoked program must then parse the command line to determine the argu- 
ments. 


BOOT(8) DYNIX/ptx 


WARNINGS 
When booting from a disk device, boot can only load programs from disks 
which have a valid VTOC at the correct location. Attempts to boot from disks 
without a valid VTOC or from a disk partition which is not defined in the VTOC 
will result in a diagnostic message being printed and a return to the powerup 
monitor. 
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DYNIX/ptx CCSFORMAT(8) 


NAME 
CCSformat — standalone embedded SCSI disk formatter 


SYNOPSIS 
From the powerup monitor: 


on SCED-based systems: 
* b 0 du(un,su)stand/CCSformat 


on SSM-based systems: 
~--> bh dv(un,su)stand/CCSformat 
DESCRIPTION 
CCSformat is the standalone embedded SCSI disk formatter. It is used to 
format both SCED and SSM SCSI disks. Refer to the Power-Up Monitor 
Guide for detailed instructions on how to use CCSformat and the powerup 
monitor. 
SEE ALSO 
boot(8) 
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DYNIX/ptx COPY(8) 


NAME 


© SYNOPSIS 


copy — perform a standalone data transfer 


From the powerup monitor: 


on SCED-based systems: 
* b 0 du(un,su)stand/copy 


on SSM-based systems: 
~-> bh dv(un,su)stand/copy 


DESCRIPTION 


copy transfers data from one device (or device partition) to another. The 
name of the program is given in standalone file notation, where du is the name 
of the device driver, un and su are the unit and subunit parameters (inter- 
preted by the device driver). These fields form the device name where the file 
to be run, stand/copy, is to be found. copy prompts for the two device names, 
which are specified in standalone file notation described above (also see 
boot(8)). copy also prompts for whether verification is selected (if selected, 
the data will be reread and verified after it is written), the offsets at which the 
transfer will begin, and the maximum number of blocks to copy. Messages are 
intended to be self-explanatory. 


WARNINGS 


When one of the devices is a disk partition, the disk must have a valid VTOC 
present in the correct location and the partition referenced must be a valid 
partition in the VTOC. If any of these conditions fail, then copy will print a 
diagnostic and exit. 


SEE ALSO 
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cp (1), mkvtoc (1M), boot (8), prtvtoc (8) 


DYNIX/ptx DUMP(8) 


NAME 


dump — standalone memory dump 


SYNOPSIS 


From the powerup monitor: 


on SCED-based systems: 
* b 80 du(un,su)stand/dump dumpdev offset special [ size ] [ -o ] 


or 
* b 80 du(un,su)stand/dump -f dumplist filename [ -o ] 


on SSM-based systems: 
--> bh ’88du(un,su)stand/dump dumpdev offset special [ size ][-o J 


or 


--> bh ’88dv(un,su)stand/dump -f dumplist filename [ -o 7 


DESCRIPTION 
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The name of the program is given in standalone file notation, whare dv is the 
name of the device driver, un and su are the unit and subunit parameters 
(interpreted by the device driver). These fields form the device name where 
the file to be run, stand/dump, is to be found. dump copies memory to offset 
blocks (specified as a decimal integer) past the beginning of device dumpdev 
(specified in standalone file notation, described above (also see boot(8)). 
Filename should be the name of the same device as dumpdev expressed as a 
standard UNIX character special file (usually beginning with /dev/rdsk/ ). 


The -f flag allows multiple dump devices to be specified. The dumplist file 
name must be specified in standalone notation, and filename should be the 
UNIX filename equivalent of the standalone filename mealies Each line in 
the dumplist file has the format: 


dumpdeu offset special [ size ] 


Each line of the file describes where a section of the dump will be placed. 


By default, all of memory is dumped, up to the size of the dump partition 
minus the offset. If the size parameter is specified, then the amount dumped 
to the partition is the minima of the partition size (as read from the VTOC ) 
and the size parameter. Because of this, the size parameter is usually not 
needed, unless the amount dumped to a dump device should be limited for 
some reason. See WARNINGS. 


dump normally aborts if an attempt is made to overwrite an existing dump. 
If -o is specified, dump will proceed with the dump even if a previous dump 
has not been cleared. 


The wn1=dumpstring powerup monitor command (for SCED-based systems), 
and the bk dumper=dumpstring’ (for SSM-based systems) or the nJ= option of 
the bootflags(1M) command, can be used to store a permanent dump invoca- 
tion string, so that operating system can automatically generate dumps. The 
file /etc/init.d/bootflags already invokes bootflags to do this. A typical invoca- 
tion of dump looks like: 


DUMP(8) DYNIX/ptx 


b 80 sd(0,0)stand/dump sd(0,1) 8000 /dev/rdsk/sd0s1 

or 

bh ’88wd(0,0)stand/dump wd(0,1) 8000 /dev/rdsk/wd0s1’ 
A typical use of dump specifying multiple dump partitions looks like: 

b 80 sd(0,0)stand/dump -f sd(0,0)etc/dumplist /etc/dumplist 
An example of /etc/dumplist looks like: 


sd(0,1) 1000 /dev/rdsk/sd0s1 
sd (8,1) 0 /dev/rdsk/sdl1s1 
za(0,1) 0 /dev/rdsk/zd0sl 


WARNINGS 
If a disk partition is used as a dump device, then that disk must have a valid 
VTOC in the correct location, and the specified partition must be a valid parti- 
tion. 

SEE ALSO 
boot(8) 
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DYNIX/ptx PRTVTOC(8) | 


NAME 


@ SYNOPSIS 


prtvtoc — print the VTOC of a standalone disk device 


From the powerup monitor: 


on SCED-based systems: 
* b 0 du(un,su)stand/prtvtoc 


on SSM-based systems: 
—--> bh dv(un,su)stand/prtvtoc 


DESCRIPTION 


The name of the program is given in standalone file notation, where du is the 
name of the device driver, un and su are the unit and subunit parameters 
(interpreted by the device driver). These fields form the device name where 
the file to be run, stand /prtvtoc, is to be found. 


prtvtoc allows the contents of the VTOC (volume table of contents) to be 
viewed in standalone mode for reference or verification. In addition to print- 
ing the contents of the VTOC, the command lists any free areas on the disk 
(that is, those without a partition). 

prtvtoc will prompt for a disk name from which to read the VTOC. The device 
name must be in-standalone notation described above (also see boot(8)). After 
the VTOC is printed, another device may be entered. To exit the command, 
type the word “exit” at the prompt. 


See prtvtoc(1M) for examples of output. 


If the device passed to prtvtoc does not contain a VTOC, an error will occur. A 
valid VTOC with a bad checksum can be printed using prtvtoc to facilitate 
recovery of a corrupted VTOC. 


SEE ALSO 
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mkvtoc(1M), prtvtoc(1M), boot(8) 


DYNIX/ptx ZDFORMAT(8) 


NAME 
zdformat — standalone disk formatter for dual-channel disk controller 


SYNOPSIS 
From the powerup monitor: 
* b 0 dvu(un,su)stand/zdformat 

DESCRIPTION 
zdformat is the standalone disk formatter for disks connected to Sequent’s 
dual-channel disk controller. See the Power-Up Monitor Guide for detailed 
instructions on how to use zdformat. 


SEE ALSO 
boot(8) 


ett 


